tazinst annotate doc/tazinst.pt.html @ rev 116

tazinst: typo
author Pascal Bellard <pascal.bellard@slitaz.org>
date Tue Nov 09 15:11:39 2021 +0000 (2021-11-09)
parents d3ae670696d2
children
rev   line source
domcox@0 1 <!DOCTYPE html>
al@11 2 <html xmlns="http://www.w3.org/1999/xhtml" lang="pt">
domcox@0 3 <head>
al@11 4 <meta charset="utf-8" />
domcox@0 5 <title>Manual do instalador Tazinst Manual</title>
domcox@0 6 <link rel="shortcut icon" href="favicon.ico" />
al@11 7 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" />
al@11 8 <script type="text/javascript" src="../slitaz-doc.js"></script>
domcox@0 9 </head>
domcox@0 10 <body>
domcox@0 11
al@11 12 <header>
domcox@0 13 <h1>Manual do Tazinst</h1>
al@11 14 </header>
domcox@0 15
domcox@0 16 <!-- Start content -->
domcox@0 17 <div id="content">
domcox@0 18
al@11 19
domcox@0 20 <h2>NOME</h2>
al@11 21
al@11 22 <p>Tazinst — Instalador do SliTaz</p>
al@11 23
domcox@0 24
domcox@0 25 <h2>SINTAXE</h2>
al@11 26
domcox@0 27 <pre>
domcox@0 28 tazinst [comando] [opção]
domcox@0 29 </pre>
domcox@0 30
al@11 31
domcox@0 32 <h2>DESCRIÇÃO</h2>
al@11 33
al@11 34 <p>O Tazinst é o instalador do SliTaz em disco rígidos, com um executável que
al@11 35 possui mais ou menos 31 Kb. Ele instala o SliTaz no disco rígido a partir de uma
al@11 36 mídia LiveCD, de um LiveUSB, de uma Imagem ISO ou a partir da web, usando uma
al@11 37 versão estável, de testes (cooking) ou rolling, ou então a partir de uma ISO
al@11 38 encontrada em um link da web (uma ISO de desenvolvimento, por exemplo,
al@11 39 encontrada num mirror oficial).</p>
al@11 40 <p>O Tazinst pode formatar uma partição em ext2, ext3, ext4 ou outro formato
al@11 41 caso os pacotes necessários estejam instalados. O diretório /home pode ser
al@11 42 instalado em qualquer partição, caso necessário, e ser formatado em qualquer
al@11 43 formato requerido. Ele também pode instalar o Grub na MBR do disco alvo. Dual
al@11 44 Boot com Windows é suportado caso uma partição Windows seja encontrada, seja
al@11 45 automaticamente ou manualmente.</p>
al@11 46 <p>O Tazinst pode atualizar o SliTaz instalado em um disco rígido, o que é útil
al@11 47 em mudanças de versão. Neste caso, a distribuição é atualizada, os dados em
al@11 48 /home são preservados e pacotes adicionais são reinstalados com sua nova
al@11 49 versão.</p>
al@11 50 <p>O Tazinst foi criado em Shell Script e é compatível com o Ash e Bash do
al@11 51 Busybox. É licenciado sob GNU Free GPL v3.</p>
al@11 52
domcox@0 53
domcox@0 54 <h2>ARQUIVO DE CONFIGURAÇÃO</h2>
al@11 55
al@11 56 <p>O instalador Tazinst pode instalar o SliTaz automaticamente usando um arquivo
al@11 57 de configuração que possui variáveis como <code>INST_TYPE="iso"</code>,
al@11 58 <code>TGT_PARTITION="/dev/hda1"</code>. Desta forma, permite aos desenvolvedores
al@11 59 criar diferentes interfaces de usuário: Dialog, GTK e Web/CGI no TazPanel. A
al@11 60 interface cria um arquivo de configuração e inicia o instalador na linha de
al@11 61 comando, informando os passos com mensagens ou uma barra de progresso.</p>
al@11 62 <p>O arquivo de configuração possui as seguintes variáveis:</p>
al@11 63
domcox@0 64 <ul>
al@11 65 <li>Variáveis que descrevem a origem de instalação:
al@11 66 <ol>
al@11 67 <li><strong>*INST_TYPE</strong>: o tipo de mídia que contem os
al@11 68 arquivos fontes, sendo
al@11 69 <strong>cdrom</strong> (SliTaz LiveCD),
al@11 70 <strong>usb</strong> (SliTaz LiveUSB),
al@11 71 <strong>iso</strong> (imagem ISO do SliTaz),
al@11 72 <strong>web</strong> (imagem ISO na Web),
al@11 73 <strong>weboot</strong>. Por exemplo:
al@11 74 <code>INST_TYPE=web</code></li>
al@11 75 <li><strong>SRC_FILE</strong>: o nome do arquivo fonte que contem o
al@11 76 SliTaz, depende do tipo de mídia escolhida:
al@11 77 <ul>
al@11 78 <li>cdrom (SliTaz LiveCD): <i>não utilizado</i></li>
al@11 79 <li>usb (SliTaz LiveUSB): nome da partição no dispositivo
al@11 80 USB, por exemplo: <code>SRC_FILE=/dev/sdb1</code></li>
al@11 81 <li>iso (imagem ISO do SliTaz): nome da imagem ISO, por
al@11 82 exemplo: <code>SRC_FILE=~/slitaz.3.0.iso</code></li>
al@11 83 <li>web (imagem ISO na Web): endereço da imagem na web, por
al@11 84 exemplo:
al@11 85 <code>SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso</code>.
al@11 86 Note que 3 endereços estão predefinidos: “stable”,
al@11 87 “cooking”, “rolling”, por exemplo:
al@11 88 <code>SRC_FILE=cooking</code> baixa utiliza a última
al@11 89 versão de testes disponível no mirror.</li>
al@11 90 <li>weboot: <i>não utilizado</i></li>
al@11 91 </ul>
al@11 92 </li>
al@11 93 </ol>
al@11 94 </li>
al@11 95 <li>Variável que determina a partição alvo:
al@11 96 <ol>
al@11 97 <li><strong>*TGT_PARTITION</strong>: nome da partição alvo em que
al@11 98 o SliTaz será instalado ou atualizado, por exemplo:
al@11 99 <code>TGT_PARTITION=/dev/hda3</code></li>
al@11 100 <li><strong>TGT_FS</strong>: se esta variável for utilizada,
al@11 101 a partição alvo será formatada no sistema de arquivos
al@11 102 especificado, caso contrário a partição ficará a salvo
al@11 103 e o diretório /home será preservado, por exemplo:
al@11 104 <code>TGT_FS=ext3</code></li>
al@11 105 <li><strong>TGT_HOME</strong>: esta variável indica, caso se queira,
al@11 106 a partição que será utilizada para o diretório /home, por
al@11 107 exemplo: <code>TGT_HOME=/dev/hda5</code></li>
al@11 108 <li><strong>TGT_HOME_FS</strong>: se esta variável for utilizada,
al@11 109 a partição /home será formatada no sistema de arquivos
al@11 110 especificado, por exemplo: <code>TGT_HOME_FS=ext2</code></li>
al@11 111 </ol>
al@11 112 </li>
al@11 113 <li>Configurações do sistema:
al@11 114 <ol>
al@11 115 <li><strong>TGT_HOSTNAME</strong>: nome do sistema, por exemplo:
al@11 116 <code>TGT_HOSTNAME=hd-slitaz</code>, por padrão
al@11 117 <code>TGT_HOSTNAME=slitaz</code></li>
al@11 118 <li><strong>TGT_ROOT_PWD</strong>: senha do usuário root, por
al@11 119 exemplo: <code>TGT_ROOT_PWD=toor</code>, por padrão
al@11 120 <code>TGT_ROOT_PWD=root</code></li>
al@11 121 <li><strong>TGT_USER</strong>: nome do usuáriou, por exemplo:
al@11 122 <code>TGT_USER=toto</code>, por padrão
al@11 123 <code>TGT_USER=tux</code></li>
al@11 124 <li><strong>TGT_USER_PWD</strong>: senha do usuário, por exemplo:
al@11 125 <code>TGT_USER_PWD=titi</code>, por padrão
al@11 126 <code>TGT_USER_PWD=tux</code></li>
al@11 127 </ol>
al@11 128 </li>
al@11 129 <li>Configuração do gerenciador de boot (bootloader):
al@11 130 <ol>
al@11 131 <li><strong>TGT_GRUB</strong>: instala o gerenciado de boot GRUB
al@11 132 (“yes” para sim, “no” para não), por exemplo:
al@11 133 <code>TGT_GRUB=yes</code>, por padrão
al@11 134 <code>TGT_GRUB=no</code></li>
al@11 135 <li><strong>TGT_WINBOOT</strong>: se esta variável for definida,
al@11 136 indica uma partição que contem um sistema Windows para que seja
al@11 137 utilizado o dual boot. Pode ser definida como “auto”, neste caso
al@11 138 será utilizada a primeira partição com Windows detectada, por
al@11 139 exemplo: <code>TGT_WINBOOT=auto</code></li>
al@11 140 </ol>
al@11 141 </li>
domcox@0 142 </ul>
domcox@0 143
al@11 144 <p>Note que somente variáveis marcadas com um asterisco nesta ajuda ajuda são
al@11 145 obrigatórias, as outras são opcionais. Então, um arquivo de configuração mínimo
al@11 146 para instalação seria:</p>
domcox@0 147
domcox@0 148 <pre>
domcox@0 149 INST_TYPE=cdrom
domcox@0 150 TGT_PARTITION=/dev/hda3
domcox@0 151 </pre>
al@11 152
al@11 153 <p>Este arquivo mínimo instala o SliTaz na partição /dev/hda3, formatando
al@11 154 a partição e utilizando o LiveCD como fonte.</p>
al@11 155
domcox@0 156
domcox@0 157 <h2>COMANDOS</h2>
domcox@0 158
al@11 159
al@11 160 <h3 id="new">new</h3>
al@11 161
al@11 162 <p>Gera um arquivo de configuração comentado que, ao ser editado pelo usuário,
al@11 163 irá instalar ou atualizar o SliTaz no dísco rígido</p>
al@11 164
domcox@0 165 <pre>
domcox@0 166 tazinst new /var/lib/tazinst.conf
domcox@0 167 </pre>
domcox@0 168
al@11 169
al@11 170 <h3 id="install">install</h3>
al@11 171
al@11 172 <p>Instala o SliTaz no dísco rígido utilizando os dados informados no arquivo
al@11 173 de configuração. Caso se decida formatar o HD, todos os dados nele serão
al@11 174 perdidos. Caso não se formate, todos os dados a não ser os contidos em /home
al@11 175 serão removidos, ou seja, o diretório /home será mantido.</p>
al@11 176
domcox@0 177 <pre>
domcox@0 178 tazinst install /var/lib/tazinst.conf
domcox@0 179 </pre>
domcox@0 180
al@11 181
al@11 182 <h3 id="upgrade">upgrade</h3>
al@11 183
al@11 184 <p>Atualiza uma instalação do SliTaz existente no disco rígido baseado nos dados
al@11 185 informados no arquivo de configuração. Os diretórios /home, /etc e /var/www
al@11 186 serão mantidos, todos os outros diretórios serão removidos. Qualquer pacote
al@11 187 adicional adicionado à antiga instalação será atualizado, desde que haja uma
al@11 188 conexão de internet disponível.</p>
al@11 189
domcox@0 190 <pre>
domcox@0 191 tazinst upgrade /var/lib/tazinst.conf
domcox@0 192 </pre>
domcox@0 193
al@11 194
al@11 195 <h3 id="showurl">showurl</h3>
al@11 196
al@11 197 <p>Mostra os endereços predefinidos nos atalhos “stable”, “cooking” e
al@11 198 “rolling”.</p>
al@11 199 <p>Note que é possível refefinir estes atalhos no arquivo de sistema:
al@11 200 /etc/slitaz/tazinst.conf.</p>
al@11 201
domcox@0 202 <pre>
domcox@0 203 tazinst showurl stable
domcox@0 204 </pre>
domcox@0 205
al@11 206
al@11 207 <h3 id="check">check</h3>
al@11 208
al@11 209 <p>Verifica um arquivo de configuração:</p>
al@11 210
domcox@0 211 <pre>
domcox@0 212 tazinst check /var/lib/tazinst.conf
domcox@0 213 </pre>
domcox@0 214
al@11 215
al@11 216 <h3 id="log">log</h3>
al@11 217
al@11 218 <p>Mostra o conteúdo do último arquivo de log:</p>
al@11 219
domcox@0 220 <pre>
domcox@0 221 tazinst log
domcox@0 222 </pre>
domcox@0 223
al@11 224
al@11 225 <h3 id="version">version</h3>
al@11 226
al@11 227 <p>Mostra informação sobre a versão:</p>
al@11 228
domcox@0 229 <pre>
domcox@0 230 tazinst version
domcox@0 231 </pre>
domcox@0 232
al@11 233
domcox@0 234 <h2>ARQUIVO DO SISTEMA</h2>
al@11 235
al@11 236 <p>O arquivo /etc/slitaz/tazinst.conf permite mudar as configurações do
al@11 237 instalador Tazinst, permitindo atribuir valores alternativos para endereços
al@11 238 da web, diretórios e arquivos. Caso se queira, deve-se criar um e modificar com
al@11 239 as seguintes variáveis:</p>
domcox@0 240
domcox@0 241 <ul>
al@11 242 <li>Endereços web predefinidos:
al@11 243 <ol>
al@11 244 <li>Endereço da versão estável atual:
al@11 245 <pre>URL_STABLE="http://mirror.slitaz.org/iso/stable/slitaz-4.0.iso"</pre>
al@11 246 </li>
al@11 247 <li>Endereço da versão de testes atual:
al@11 248 <pre>URL_COOKING="http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso"</pre>
al@11 249 </li>
al@11 250 <li>Endereço da versão rolling atual:
al@11 251 <pre>URL_ROLLING="http://mirror.slitaz.org/iso/rolling/slitaz-core.iso"</pre>
al@11 252 </li>
al@11 253 </ol>
al@11 254 </li>
al@11 255 <li>Mount points:
al@11 256 <ol>
al@11 257 <li>Ponto de montagem mídia de origem:
al@11 258 <pre>SOURCE_ROOT="/media/source"</pre></li>
al@11 259 <li>Ponto de montagem da partição alvo:
al@11 260 <pre>TARGET_ROOT="/mnt/target"</pre></li>
al@11 261 </ol>
al@11 262 </li>
al@11 263 <li>Log e Debug:
al@11 264 <ol>
al@11 265 <li>Localização do arquivo de Log:
al@11 266 <pre>LOG="/var/log/tazinst.log"</pre></li>
al@11 267 <li>Debugging: (quiet ⇒ 0, debug ⇒ 1)
al@11 268 <pre>DEBUG=0</pre>
al@11 269 É altamente recomendável configurar a variável DEBUG como
al@11 270 <code>DEBUG=1</code> e anexar o conteúdo do arquivo de log caso
al@11 271 seja necessário abrir um aviso de bug para os
al@11 272 desenvolvedores.</li>
al@11 273 </ol>
al@11 274 </li>
domcox@0 275 </ul>
domcox@0 276
domcox@0 277
domcox@0 278 <h2>MANTENEDORES</h2>
al@11 279
al@11 280 <p>Christophe Lincoln &lt;pankso at slitaz.org&gt;<br />
al@11 281 Dominique Corbex &lt;domcox at slitaz.org&gt;</p>
domcox@0 282
domcox@0 283 <!-- End of content -->
domcox@0 284 </div>
domcox@0 285
al@11 286 <footer>
pascal@21 287 Copyright © <span class="year"></span> <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
al@11 288 </footer>
domcox@0 289
domcox@0 290 </body>
domcox@0 291 </html>