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