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