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 <pankso at slitaz.org><br />
|
al@11
|
281 Dominique Corbex <domcox at slitaz.org></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>
|