Manual do Tazinst

NOME

Tazinst — Gerenciador de instalação do SliTaz (Tiny autonomous zone installer manager)

SINTAXE

tazinst [--machine] [command] <setting> <value> <file>

Os comandos atuam sobre um arquivo de instalação que contém as configurações da instalação. O arquivo padrão é ./tazinst.rc; outro arquivo pode ser indicado como último argumento de qualquer comando. Com --machine, a saída consiste em registros legíveis por máquina, destinados às interfaces (frontends) (veja doc/protocol.txt).

DESCRIÇÃO

O Tazinst é um instalador leve do SliTaz em disco rígido. Ele instala o SliTaz em um disco rígido a partir do sistema live em execução (LiveCD ou pendrive LiveUSB) ou a partir de uma imagem ISO localizada em um dos seus discos.

O Tazinst pode formatar a partição de destino (ext2, ext3, ext4 e outros, conforme instalados no sistema live). O diretório pessoal (home) pode ficar em outra partição, que também pode ser formatada. O Tazinst pode instalar o gerenciador de inicialização (bootloader) GRUB2 em máquinas BIOS e UEFI, adicionar uma entrada de dual-boot para uma partição Windows™ existente e adicionar entradas de recuperação que iniciam o sistema live a partir da RAM ou o SliTaz a partir da web.

O Tazinst também pode atualizar um SliTaz já instalado em uma partição do disco rígido, algo útil nas mudanças de versão: as configurações, o /home e a lista de pacotes são salvos, a nova versão é instalada e, em seguida, eles são restaurados. Os pacotes adicionais são reinstalados se houver uma conexão ativa com a Internet.

O Tazinst foi escrito do zero em shell script e é compatível com o Busybox Ash e o Bash. O Tazinst é distribuído sob a licença GNU GPL v3. O instalador precisa de privilégios de root: execute-o com su.

CONFIGURAÇÕES

O Tazinst realiza uma instalação automática a partir de algumas configurações armazenadas no arquivo de instalação. As configurações obrigatórias não podem ficar vazias; as demais são opcionais. No modo upgrade, apenas uma parte delas se aplica — execute tazinst get settings para listar as configurações do modo atual.

mode

Obrigatória. Modo de instalação: install (nova instalação em uma partição) ou upgrade (atualização de um SliTaz instalado, mantendo configurações, usuários e pacotes). Digite tazinst help mode para listar os modos suportados.

media

Obrigatória. A mídia contendo os arquivos fontes do SliTaz: cdrom (LiveCD do SliTaz), usb (pendrive LiveUSB do SliTaz) ou iso (imagem ISO em um disco local). Somente as mídias disponíveis no seu sistema são listadas por tazinst list media.

source

Obrigatória, exceto com a mídia cdrom. A fonte do SliTaz, conforme a media: com usb, a partição do pendrive live (tazinst list usb); com iso, o arquivo da imagem ISO (tazinst list iso).

root_uuid

Obrigatória. A partição onde o SliTaz será instalado (ou o sistema SliTaz a ser atualizado). Digite tazinst list uuid para listar as partições dos seus discos.

root_format

Opcional. Se definida, a partição de destino é formatada com o sistema de arquivos indicado; em caso de dúvida, escolha ext4. A formatação apaga tudo o que há na partição. Sem formatação, ela também é esvaziada, exceto o /home. Digite tazinst help root_format para ver os sistemas de arquivos suportados e tazinst list format para ver os que estão instalados no seu sistema.

home_uuid

Opcional. Uma partição separada para os arquivos pessoais (/home), preservada entre reinstalações e atualizações. Deixe vazia para não usar uma partição separada.

home_format

Opcional. Se definida, a partição /home separada é formatada. Deixe-a vazia para manter os arquivos que ela contém — a formatação apaga tudo o que há na partição.

hostname

Obrigatória. O nome da máquina na rede, slitaz por padrão. Ele pode ser alterado após a instalação.

root_pwd

Opcional. Senha do superusuário [root], root por padrão. O administrador root gerencia todo o sistema: escolha uma senha forte, com números e caracteres especiais.

user_login

Obrigatória. Nome do primeiro usuário, tux por padrão. O primeiro usuário guarda seus arquivos pessoais em /home/<user> e pertence ao grupo audio.

user_pwd

Opcional. Senha do primeiro usuário, tux por padrão. Ela precisa ser forte se a máquina aceitar conexões SSH.

bootloader

Opcional. Instala um gerenciador de inicialização: defina-a como auto e o GRUB2 iniciará o SliTaz ao ligar a máquina, em máquinas BIOS e UEFI. Ignore-a (valor vazio) somente se outro gerenciador de inicialização controlar este disco: você terá que configurá-lo para iniciar o SliTaz. Digite tazinst help bootloader para listar os gerenciadores de inicialização suportados.

liveboot

Opcional, requer um gerenciador de inicialização. Adiciona uma entrada no menu de inicialização que inicia o sistema live na RAM, para recuperação. Aceita auto (sim) ou um valor vazio (não). A entrada pede a senha de root.

webboot

Opcional, requer um gerenciador de inicialização. Adiciona uma entrada no menu de inicialização que inicia o SliTaz a partir da Internet. Aceita auto (sim) ou um valor vazio (não). A entrada pede a senha de root.

winboot

Opcional, requer um gerenciador de inicialização. Adiciona uma entrada no menu de inicialização que inicia o Windows: auto seleciona a primeira partição Windows™ encontrada; ou indique uma partição. Digite tazinst list winboot para ver os valores que o tazinst detecta.

COMANDOS

new

Cria um novo arquivo de instalação autodocumentado. Por padrão, define o formato da raiz como ext4 e o gerenciador de inicialização como auto quando as ferramentas estão disponíveis. Recusa-se a sobrescrever um arquivo existente.

Exemplos:

tazinst new
tazinst new /var/lib/tazinst.conf

set

Atribui um novo valor a uma configuração e, em seguida, verifica-o.

Exemplos:

tazinst set mode install
tazinst set mode install /var/lib/tazinst.conf

unset

Apaga o valor de uma configuração.

Exemplos:

tazinst unset home_format
tazinst unset home_format /var/lib/tazinst.conf

get

Exibe o valor de uma configuração ou, sem argumento, de todas as configurações. tazinst get settings lista as configurações que se aplicam ao modo atual.

Exemplos:

tazinst get
tazinst get mode
tazinst get mode /var/lib/tazinst.conf

check

Verifica se há erros em uma configuração ou, sem argumento, em todas as configurações ativas. Com --machine, exibe um registro key status message por configuração (ok, warning, error).

Exemplos:

tazinst check
tazinst check mode
tazinst check mode /var/lib/tazinst.conf

describe

Descreve, em ordem, as configurações que uma interface (frontend) deve pedir, com um registro key type required active value label help warning por configuração. Execute-o novamente após cada alteração: os tipos e os indicadores de ativação acompanham os valores (source com um CD, home format sem partição home, entradas de inicialização sem gerenciador de inicialização).

Exemplo:

tazinst describe

options

Lista os valores que uma configuração pode assumir, com um registro value label por valor. Um valor vazio é válido quando listado (sem formatação, sem gerenciador de inicialização, sem home separada...). As configurações de texto e de senha não têm opções.

Exemplo:

tazinst options root_format

plan

Mostra o que execute fará, para uma página de resumo: modo, fonte, formatação ou limpeza, home, nome da máquina, usuário, gerenciador de inicialização e entradas de inicialização, com um registro por ação.

Exemplo:

tazinst plan

help

Exibe uma ajuda curta sobre uma configuração ou, sem argumento, sobre todas as configurações. Também documenta as fontes cdrom, usb e iso.

Exemplo:

tazinst help mode

list

Lista os recursos do sistema. Os recursos são:

mode	Modos de instalação disponíveis
media	Mídias disponíveis para a instalação. Exemplo: cdrom não é listado em sistemas sem unidade de CD-ROM
usb	Partições de discos USB
iso	Imagens ISO em unidades locais: /root, /home e discos montados em /media ou /mnt
uuid	Partições dos seus discos, com sistema de arquivos e rótulo
partitions	Todas as partições, em formato legível por máquina, com tamanho, função e sistema detectado
format	Sistemas de arquivos instalados
bootloader	Gerenciadores de inicialização disponíveis
partition_table	Esquemas de tabela de partições dos discos locais
winboot	Partições Windows™ inicializáveis

Exemplos:

tazinst list
tazinst list media

execute

Realiza a instalação ou a atualização descrita pelo arquivo de instalação. Requer privilégios de root e recusa-se a executar duas vezes simultaneamente (arquivo de trava). Se você optou pela formatação, todos os dados da partição são perdidos; caso contrário, ela é esvaziada, exceto um /home existente. Na atualização, /etc /home /var/www são preservados. Envie SIGTERM para cancelar; o log completo fica em /var/log/tazinst.log e é copiado para o sistema instalado. Com --machine, emite registros progress percent message, info message e error code message, e termina com código 0 em caso de sucesso.

Exemplos:

tazinst execute
tazinst execute /var/lib/tazinst.conf

clean

Remove o arquivo de instalação, os arquivos temporários e o arquivo de log.

Exemplos:

tazinst clean
tazinst clean /var/lib/tazinst.conf

log

Exibe o conteúdo do último arquivo de log e sai.

Exemplo:

tazinst log

version

Exibe as informações de versão e sai.

Exemplo:

tazinst version

usage

Exibe uma ajuda curta e sai.

Exemplo:

tazinst usage

Códigos de saída

1	Erro nos parâmetros
2	Erro no arquivo de instalação
3	Erro na fonte
4	Erro no destino
5	Recurso ausente
6	Nenhum sistema SliTaz para atualizar
7	Outra instância está em execução
8	Erro interno
9	Cancelado pelo usuário

INTERFACES

Três interfaces (frontends) conduzem o backend tazinst passo a passo por meio do seu protocolo de máquina (doc/protocol.txt): etapas, valores e verificações vêm todos do tazinst, de modo que uma configuração adicionada ao backend aparece sem nenhuma alteração nas interfaces. Todas requerem privilégios de root e aceitam um arquivo de instalação opcional:

slitaz-installer [install file]
tazinst-tui [install file]
tazinst-gtk [install file]

Sem argumento, elas criam um novo arquivo de instalação em /tmp (removido ao sair, pois contém senhas) e percorrem todas as etapas até uma página de resumo — a última chance de cancelar ou voltar. Quando recebem um arquivo de instalação já pronto, abrem-no diretamente na página de resumo.

• slitaz-installer: interface dialog, em shell script.
• tazinst-tui: interface ncurses em C (src/), com o tema laranja do SliTaz e barra de progresso durante a instalação.
• tazinst-gtk: interface GTK3 em C (src/), para o desktop live; requer privilégios de root, execute-a com subox.

EXEMPLOS

Instalação

Instalar o SliTaz em uma partição do seu disco rígido a partir de uma imagem ISO. A partição raiz não é formatada: todos os dados são removidos, exceto um diretório /home existente.

1. Crie um arquivo de instalação:

   # tazinst new

2. Defina o modo como install:

   # tazinst set mode install

3. Use uma ISO como fonte:

   # tazinst set media iso

4. Selecione a imagem ISO:

   # tazinst set source ~/slitaz-rolling.iso

5. Selecione a partição onde instalar o SliTaz:

   # tazinst set root_uuid /dev/sda1

6. Instale um gerenciador de inicialização:

   # tazinst set bootloader auto

7. Verifique suas configurações, execute e faça a limpeza:

   # tazinst check
   # tazinst execute
   # tazinst clean

Instalação avançada

Instalar o SliTaz com uma partição home separada e dual-boot com o Windows™. As partições raiz e /home são formatadas (todos os dados existentes são perdidos).

1. Crie um arquivo de instalação:

   # tazinst new

2. Defina o modo como install:

   # tazinst set mode install

3. Use um LiveUSB como fonte:

   # tazinst set media usb

4. Selecione a partição do pendrive live:

   # tazinst set source /dev/sdb1

5. Selecione a partição onde instalar o SliTaz:

   # tazinst set root_uuid /dev/sda1

6. Formate / em ext4:

   # tazinst set root_format ext4

7. Use uma partição /home separada:

   # tazinst set home_uuid /dev/sda2

8. Formate /home em ext4:

   # tazinst set home_format ext4

9. Instale um gerenciador de inicialização e o dual-boot com o Windows™:

   # tazinst set bootloader auto
   # tazinst set winboot auto

10. Verifique, execute e faça a limpeza:

    # tazinst check
    # tazinst execute
    # tazinst clean

Atualização

Atualizar um sistema SliTaz já instalado. /etc /home /var/www são preservados; todos os outros diretórios são substituídos. Os pacotes adicionais são atualizados se houver uma conexão ativa com a Internet.

1. Crie um arquivo de instalação:

   # tazinst new

2. Defina o modo como upgrade:

   # tazinst set mode upgrade

3. Use uma ISO como fonte:

   # tazinst set media iso

4. Selecione a imagem ISO:

   # tazinst set source ~/slitaz-rolling.iso

5. Selecione a partição que contém o SliTaz a ser atualizado:

   # tazinst set root_uuid /dev/sda1

6. Verifique, execute e faça a limpeza:

   # tazinst check
   # tazinst execute
   # tazinst clean

Dicas

1. Nem todas as configurações se aplicam a todos os modos. Liste as do seu modo:

   # tazinst get settings

2. Visualize a instalação antes de executá-la:

   # tazinst plan

ARQUIVOS

ARQUIVO DE INSTALAÇÃO

As configurações são salvas no arquivo de instalação e depois usadas pelo tazinst para uma instalação automática. O arquivo padrão é ./tazinst.rc, mas um nome de arquivo opcional pode ser passado como parâmetro. O arquivo de instalação é autodocumentado. O comando clean o apaga.

ARQUIVO DO SISTEMA

O arquivo de configuração /etc/slitaz/tazinst.conf predefine os valores padrão do tazinst: nome da máquina, senhas, login do usuário e a lista de imagens SliTaz conhecidas (URL_ISO). Qualquer configuração pode ser predefinida adicionando seu nome em maiúsculas com o valor desejado.

Exemplo:

Para predefinir o nome do sistema e o usuário em todas as instalações:

HOSTNAME="slitaz"
USER_LOGIN="tux"

ARQUIVO DE LOG

O arquivo /var/log/tazinst.log contém o log da instalação e é copiado para o sistema instalado. O comando clean o apaga.

MANTENEDORES

Christophe Lincoln <pankso at slitaz.org>
Dominique Corbex <domcox at slitaz.org>