tazinst diff 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 diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/tazinst.pt.html	Thu Feb 14 12:48:04 2013 +0100
     1.3 @@ -0,0 +1,352 @@
     1.4 +<!DOCTYPE html>
     1.5 +html xmlns="http://www.w3.org/1999/xhtml">
     1.6 +<head>
     1.7 +	<title>Manual do instalador Tazinst Manual</title>
     1.8 +	<meta charset="utf-8" />
     1.9 +	<link rel="shortcut icon" href="favicon.ico" />
    1.10 +	<link rel="stylesheet" type="text/css" href="style.css" />
    1.11 +</head>
    1.12 +<body>
    1.13 +
    1.14 +<!-- Header -->
    1.15 +<div id="header">
    1.16 +	<h1>Manual do Tazinst</h1>
    1.17 +</div>
    1.18 +
    1.19 +<!-- Start content -->
    1.20 +<div id="content">
    1.21 +
    1.22 +<h2>NOME</h2>
    1.23 +<p>
    1.24 +	Tazinst - Instalador do SliTaz
    1.25 +</p>
    1.26 +
    1.27 +<h2>SINTAXE</h2>
    1.28 +<pre>
    1.29 +tazinst [comando] [opção]
    1.30 +</pre>
    1.31 +
    1.32 +<h2>DESCRIÇÃO</h2> 
    1.33 +<p> 
    1.34 +    O Tazinst é o instalador do SliTaz em disco rígidos, com um executável que
    1.35 +    possui mais ou menos 31 Kb. Ele instala o SliTaz no disco rígido a partir
    1.36 +    de uma mídia LiveCD, de um LiveUSB, de uma Imagem ISO ou a partir da web,
    1.37 +    usando uma versão estável, de testes (cooking) ou rolling, ou então 
    1.38 +    a partir de uma ISO encontrada em um link da web (uma ISO de
    1.39 +    desenvolvimento, por exemplo, encontrada num mirror oficial).
    1.40 +</p>
    1.41 +<p>
    1.42 +    O Tazinst pode formatar uma partiçÃo em ext2, ext3, ext4 ou outro formato
    1.43 +    caso os pacotes necessários estejam instalados. O diretório /home pode ser
    1.44 +    instalado em qualquer partição, caso necessário, e ser formatado em qualquer
    1.45 +    formato requerido. Ele também pode instalar o Grub na MBR do disco alvo. 
    1.46 +    Dual Boot com Windows é suportado caso uma partição Windows seja encontrada,
    1.47 +    seja automaticamente ou manualmente.
    1.48 +</p>
    1.49 +<p>
    1.50 +    O Tazinst pode atualizar o SliTaz instalado em um disco rígido, o que é
    1.51 +    útil em mudanças de versão. Neste caso, a distribuição é atualizada,
    1.52 +    os dados em /home são preservados e pacotes adicionais são reinstalados
    1.53 +    com sua nova versão.
    1.54 +</p>
    1.55 +<p>
    1.56 +    O Tazinst foi criado em Shell Script e é compatível com o Ash e Bash
    1.57 +    do Busybox. É licenciado sob GNU Free gpl v3.
    1.58 +</p>
    1.59 +
    1.60 +<h2>ARQUIVO DE CONFIGURAÇÃO</h2>
    1.61 +<p>
    1.62 +    O instalador Tazinst pode instalar o SliTaz automaticamente usando um
    1.63 +    arquivo de configuração que possui variáveis como
    1.64 +	<code>INST_TYPE="iso"</code>, <code>TGT_PARTITION="/dev/hda1"</code>.
    1.65 +    Desta forma, permite aos desenvolvedores criar diferentes interfaces de
    1.66 +    usuário: Dialog, GTK e Web/CGI no TazPanel. A interface cria um arquivo
    1.67 +    de configuração e inicia o instalador na linha de comando, informando os
    1.68 +    passos com mensagens ou uma barra de progresso.
    1.69 +</p>
    1.70 +<p>
    1.71 +    O arquivo de configuração possui as seguintes variáveis:
    1.72 +</p>
    1.73 +<ul>
    1.74 +	<li class="level1"><div class="li">
    1.75 +    Variáveis que descrevem a origem de instalação:
    1.76 +<ol>
    1.77 +	<li class="level1"><div class="li">
    1.78 +    <strong>*INST_TYPE</strong>: o tipo de mídia que contem os arquivos fontes,
    1.79 +    sendo <strong>cdrom</strong> (SliTaz LiveCD), <strong>usb</strong>
    1.80 +	(SliTaz LiveUSB), <strong>iso</strong> (imagem ISO do SliTaz),
    1.81 +	<strong>web</strong> (imagem ISO na Web), <strong>weboot</strong>. Por
    1.82 +	exemplo: <code>INST_TYPE=web</code>
    1.83 +	</div></li>
    1.84 +	<li class="level1"><div class="li">
    1.85 +    <strong>SRC_FILE</strong>: o nome do arquivo fonte que contem o SliTaz,
    1.86 +    depende do tipo de mídia escolhida:
    1.87 +	<ul>
    1.88 +	<li class="level2"><div class="li">cdrom (SliTaz LiveCD): 
    1.89 +	<i>não utilizado</i>
    1.90 +	</div></li>
    1.91 +    <li class="level2"><div class="li">usb (SliTaz LiveUSB): nome da partição
    1.92 +    no dispositivo USB, por exemplo: <code>SRC_FILE=/dev/sdb1</code>
    1.93 +	</div></li>
    1.94 +    <li class="level2"><div class="li">iso (imagem ISO do SliTaz): nome da 
    1.95 +    imagem ISO, por exemplo: <code>SRC_FILE=~/slitaz.3.0.iso</code>
    1.96 +	</div></li>
    1.97 +    <li class="level2"><div class="li">web (imagem ISO na Web): endereço da
    1.98 +    imagem na web, por exemplo: 
    1.99 +    <code>
   1.100 +	SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso</code>. 
   1.101 +    Note que 3 endereços estão predefinidos: 'stable', 'cooking, 'rolling',
   1.102 +    por exemplo: 
   1.103 +    <code>SRC_FILE=cooking</code> baixa utiliza a última versão de testes
   1.104 +    disponível no mirror.
   1.105 +	</div></li>
   1.106 +	<li class="level2"><div class="li">weboot: <i>não utilizado</i>
   1.107 +	</div></li> 
   1.108 +	</ul>
   1.109 +	</div></li>
   1.110 +</ol>
   1.111 +</div></li>
   1.112 +</ul>
   1.113 +
   1.114 +<ul>
   1.115 +    <li class="level1"><div class="li">Variável que determina a partição alvo:
   1.116 +<ol>
   1.117 +	<li class="level1"><div class="li">
   1.118 +    <strong>*TGT_PARTITION</strong>: nome da partição alvo em que o SliTaz será
   1.119 +    instalado ou atualizado, por exemplo: <code>TGT_PARTITION=/dev/hda3</code>
   1.120 +	</div></li>
   1.121 +	<li class="level1"><div class="li">
   1.122 +    <strong>TGT_FS</strong>: se esta variável for utilizada, a partição alvo
   1.123 +    será formatada no sistema de arquivos especificado, caso contrário a
   1.124 +    partição ficará a salvo e o diretório /home será preservado, por exemplo:
   1.125 +	<code>TGT_FS=ext3</code>
   1.126 +	</div></li>
   1.127 +	<li class="level1"><div class="li">
   1.128 +    <strong>TGT_HOME</strong>: esta variável indica, caso se queira, a partição
   1.129 +    que será utilizada para o diretório /home, por exemplo:
   1.130 +	<code>TGT_HOME=/dev/hda5</code>
   1.131 +	</div></li>
   1.132 +	<li class="level1"><div class="li">
   1.133 +    <strong>TGT_HOME_FS</strong>: se esta variável for utilizada, a partição
   1.134 +    /home será formatada no sistema de arquivos especificado, por exemplo:
   1.135 +	<code>TGT_HOME_FS=ext2</code>
   1.136 +	</div></li>
   1.137 +</ol>
   1.138 +</div></li>
   1.139 +</ul>
   1.140 +
   1.141 +<ul>
   1.142 +	<li class="level1"><div class="li">Configurações do sistema:
   1.143 +
   1.144 +<ol>
   1.145 +	<li class="level1"><div class="li">
   1.146 +	<strong>TGT_HOSTNAME</strong>: nome do sistema, por exemplo:
   1.147 +	<code>TGT_HOSTNAME=hd-slitaz</code>, por padrão
   1.148 +	<code>TGT_HOSTNAME=slitaz</code>
   1.149 +	</div></li>
   1.150 +	<li class="level1"><div class="li">
   1.151 +	<strong>TGT_ROOT_PWD</strong>: senha do usuário root, por exemplo:
   1.152 +	<code>TGT_ROOT_PWD=toor</code>, por padrão 
   1.153 +	<code>TGT_ROOT_PWD=root</code>
   1.154 +	</div></li>
   1.155 +	<li class="level1"><div class="li">
   1.156 +	<strong>TGT_USER</strong>: nome do usuáriou, por exemplo: 
   1.157 +    <code>TGT_USER=toto</code>, por padrão 
   1.158 +    <code>TGT_USER=tux</code>
   1.159 +	</div></li>
   1.160 +	<li class="level1"><div class="li">
   1.161 +	<strong>TGT_USER_PWD</strong>: senha do usuário, por exemplo:
   1.162 +	<code>TGT_USER_PWD=titi</code>, por padrão
   1.163 +	<code>TGT_USER_PWD=tux</code>
   1.164 +	</div></li>
   1.165 +</ol>
   1.166 +</div></li>
   1.167 +</ul>
   1.168 +
   1.169 +<ul>
   1.170 +    <li class="level1"><div class="li"> Configuração do gerenciador de boot
   1.171 +    (bootloader):
   1.172 +
   1.173 +<ol>
   1.174 +	<li class="level1"><div class="li">
   1.175 +    <strong>TGT_GRUB</strong>: instala o gerenciado de boot GRUB
   1.176 +    ('yes' para sim, 'no' para não), por exemplo:
   1.177 +    <code>TGT_GRUB=yes</code>, por padrão
   1.178 +    <code>TGT_GRUB=no</code>
   1.179 +	</div></li>
   1.180 +	<li class="level1"><div class="li">
   1.181 +    <strong>TGT_WINBOOT</strong>: se esta variável for definida, indica
   1.182 +    uma partição que contem um sistema Windows para que seja utilizado o dual
   1.183 +    boot. Pode ser definida como 'auto', neste caso será utilizada a primeira
   1.184 +    partição com Windows detectada, por exemplo:
   1.185 +	<code>TGT_WINBOOT=auto</code>
   1.186 +	</div></li>
   1.187 +</ol>
   1.188 +</div></li>
   1.189 +</ul>
   1.190 +
   1.191 +<p>
   1.192 +    Note que somente variáveis marcadas com um asterisco nesta ajuda ajuda
   1.193 +    são obrigatórias, as outras são opcionais. Então, um arquivo de configuração
   1.194 +    mínimo para instalação seria:
   1.195 +</p>
   1.196 +<pre>
   1.197 +INST_TYPE=cdrom
   1.198 +TGT_PARTITION=/dev/hda3
   1.199 +</pre>
   1.200 +<p>
   1.201 +    Este arquivo mínimo instala o SliTaz na partição /dev/hda3, formatando a
   1.202 +    partição e utilizando o LiveCD como fonte.
   1.203 +</p>
   1.204 +
   1.205 +<h2>COMANDOS</h2>
   1.206 +
   1.207 +<a id="new"></a>
   1.208 +<h3>new</h3>
   1.209 +<p>
   1.210 +    Gera um arquivo de configuração comentado que, ao ser editado pelo usuário,
   1.211 +    irá instalar ou atualizar o SliTaz no dísco rígido
   1.212 +</p>
   1.213 +<pre>
   1.214 +tazinst new /var/lib/tazinst.conf
   1.215 +</pre>
   1.216 +
   1.217 +<a id="install"></a>
   1.218 +<h3>install</h3>
   1.219 +<p>
   1.220 +    Instala o SliTaz no dísco rígido utilizando os dados informados no 
   1.221 +    arquivo de configuração. Caso se decida formatar o HD, todos os dados nele
   1.222 +    serão perdidos. Caso não se formate, todos os dados a não ser os contidos
   1.223 +    em /home serão removidos, ou seja, o diretório /home será mantido.
   1.224 +</p>
   1.225 +<pre>
   1.226 +tazinst install /var/lib/tazinst.conf
   1.227 +</pre>
   1.228 +
   1.229 +<a id="upgrade"></a>
   1.230 +<h3>upgrade</h3>
   1.231 +<p>
   1.232 +    Atualiza uma instalação do SliTaz existente no disco rígido baseado nos
   1.233 +    dados informados no arquivo de configuração. Os diretórios /home, /etc e
   1.234 +    /var/www serão mantidos, todos os outros diretórios serão removidos. 
   1.235 +    Qualquer pacote adicional adicionado à antiga instalação será atualizado,
   1.236 +    desde que haja uma conexão de internet disponível.
   1.237 +</p>
   1.238 +<pre>
   1.239 +tazinst upgrade /var/lib/tazinst.conf
   1.240 +</pre>
   1.241 +
   1.242 +<a id="showurl"></a>
   1.243 +<h3>showurl</h3>
   1.244 +<p>
   1.245 +    Mostra os endereços predefinidos nos atalhos 'stable', 'cooking' e
   1.246 +    'rolling'.
   1.247 +</p>
   1.248 +<p>
   1.249 +    Note que é possível refefinir estes atalhos no arquivo de sistema:
   1.250 +	/etc/slitaz/tazinst.conf.
   1.251 +</p>
   1.252 +<pre>
   1.253 +tazinst showurl stable
   1.254 +</pre>
   1.255 +
   1.256 +<a id="check"></a>
   1.257 +<h3>check</h3>
   1.258 +<p>
   1.259 +	Verifica um arquivo de configuração:
   1.260 +</p>
   1.261 +<pre>
   1.262 +tazinst check /var/lib/tazinst.conf
   1.263 +</pre>
   1.264 +
   1.265 +<a id="log"></a>
   1.266 +<h3>log</h3>
   1.267 +<p>
   1.268 +	Mostra o conteúdo do último arquivo de log:
   1.269 +</p>
   1.270 +<pre>
   1.271 +tazinst log
   1.272 +</pre>
   1.273 +
   1.274 +<a id="version"></a>
   1.275 +<h3>version</h3>
   1.276 +<p>
   1.277 +	Mostra informação sobre a versão:
   1.278 +</p>
   1.279 +<pre>
   1.280 +tazinst version
   1.281 +</pre>
   1.282 +
   1.283 +<h2>ARQUIVO DO SISTEMA</h2>
   1.284 +<p>
   1.285 +    O arquivo /etc/slitaz/tazinst.conf permite mudar as configurações do
   1.286 +    instalador Tazinst, permitindo atribuir valores alternativos para 
   1.287 +    endereços da web, diretórios e arquivos. Caso se queira, deve-se criar um
   1.288 +    e modificar com as seguintes variáveis:
   1.289 +</p>
   1.290 +
   1.291 +<ul>
   1.292 +<li class="level1"><div class="li">Endereços web predefinidos:
   1.293 +
   1.294 +<ol>
   1.295 +	<li class="level1"><div class="li">Endereço da versão estável atual:<br />
   1.296 +	<code>URL_STABLE="http://mirror.slitaz.org/iso/stable/slitaz-4.0.iso"
   1.297 +	</code>
   1.298 +	</div></li>
   1.299 +	<li class="level1"><div class="li">Endereço da versão de testes atual:<br />
   1.300 +	<code>URL_COOKING="http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso"
   1.301 +	</code>
   1.302 +    </div></li> <li class="level1"><div class="li">Endereço da versão rolling atual:<br />
   1.303 +    <code>URL_ROLLING="http://mirror.slitaz.org/iso/rolling/slitaz-core.iso" 
   1.304 +    </code></div></li></ol>
   1.305 +</div></li>
   1.306 +</ul>
   1.307 +
   1.308 +<ul>
   1.309 +<li class="level1"><div class="li">Mount points:
   1.310 +
   1.311 +<ol>
   1.312 +	<li class="level1"><div class="li">
   1.313 +	Ponto de montagem mídia de origem:<br />
   1.314 +	<code>SOURCE_ROOT="/media/source"</code>
   1.315 +	</div></li>
   1.316 +	<li class="level1"><div class="li">
   1.317 +	Ponto de montagem da partição alvo:<br />
   1.318 +	<code>TARGET_ROOT="/mnt/target"</code>
   1.319 +	</div></li>
   1.320 +</ol>
   1.321 +</div></li>
   1.322 +</ul>
   1.323 +
   1.324 +<ul>
   1.325 +<li class="level1"><div class="li">Log e Debug:
   1.326 +
   1.327 +<ol>
   1.328 +	<li class="level1"><div class="li">Localização do arquivo de Log:<br />
   1.329 +	<code>LOG="/var/log/tazinst.log"</code>
   1.330 +	</div></li>
   1.331 +	<li class="level1"><div class="li">Debugging: (quiet => 0, debug => 1)<br />
   1.332 +	<code>DEBUG=0</code><br />
   1.333 +        É altamente recomendável configurar a variável DEBUG como  
   1.334 +        <code>DEBUG=1</code> e anexar o conteúdo do arquivo de log caso seja
   1.335 +        necessário abrir um aviso de bug para os desenvolvedores.
   1.336 +	</div></li>
   1.337 +</ol>
   1.338 +</div></li>
   1.339 +</ul>
   1.340 +
   1.341 +<h2>MANTENEDORES</h2>
   1.342 +<p>
   1.343 +	Christophe Lincoln &lt;pankso at slitaz.org&gt; <br />
   1.344 +	Dominique Corbex &lt;domcox at slitaz.org&gt;
   1.345 +</p>
   1.346 +
   1.347 +<!-- End of content -->
   1.348 +</div>
   1.349 +
   1.350 +<div id="footer">
   1.351 +	Copyright &copy; 2012 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
   1.352 +</div>
   1.353 +
   1.354 +</body>
   1.355 +</html>