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

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