## NOM

Tazinst — Tiny autonomous zone installer manager

## SYNTAXE

    tazinst [commande] [option]

## DESCRIPTION

Tazinst est l'installateur ultra léger (~31 Ko) de SliTaz sur disque dur. Il permet d'installer SliTaz au choix à partir du Live-CD, d'une clé LiveUSB, d'une image ISO de SliTaz, ou depuis le web en téléchargeant la version stable, la version cooking ou en donnant le lien http d'une autre iso (ex : iso de developpement).

Tazinst permet de formatter la partition cible aux formats de base ext2, ext3, ext4 ou d'autres formats si les paquets correspondants ont été installés. La partition /home peut être installée sur une autre partition, et si besoin être formattée avant l'installation dans un des formats disponibles. Tazinst peut, à la demande, installer le chargeur de démarrage Grub dans le mbr du disque cible. Un dual-boot avec une partition Windows™ existante est possible, la recherche de la partition Windows™ étant soit automatique, soit précisée manuellement.

Tazinst permet également la mise à jour de SliTaz déjà installé sur une partition du disque dur, ce qui est pratique en cas de changement de version. Dans ce cas, SliTaz est mis à jour, les données présentes dans /home sont préservées, et les paquets supplémentaires sont réinstallés dans la nouvelle version.

Tazinst a été créé pour les besoins de SliTaz GNU/Linux, mini distribution autonome.

Tazinst, écrit en script shell à partir de zéro est compatible Bash, et fonctionne avec Ash du projet Busybox. Tazinst est distribué sous license libre GNU GPL v3.

## FICHIER DE PARAMÈTRES

L'installateur Tazinst permet de réaliser une installation automatiquement à l'aide d'un simple fichier de paramètres contenant des variables significatives telles que : `INST_TYPE="iso"`, `TGT_PARTITION="/dev/hda1"`. De cette manière, cela permet aux développeurs de créer différents types de frontend : Dialog, GTK et CGI/web dans TazPanel. Le frontend doit juste créer un fichier de paramètres, puis lancer tazinst en ligne de commande et afficher un rapport d'avancement des différentes étapes (Jauges et/ou messages).

Le fichier de paramètres contient les variables suivantes :

- Les variables décrivant la source d'installation :
  1. *INST_TYPE : le type du support contenant les fichiers sources de SliTaz, au choix : cdrom (LiveCD de SliTaz), usb (LiveUSB de SliTaz), iso (Image ISO de SliTaz), web (Image ISO sur le Web), weboot, ex : `INST_TYPE=web`
  2. *SRC_FILE : le nom de la source contenant SliTaz. Il dépend du type de support :
     - cdrom (LiveCD de SliTaz) : inutilisé
     - usb (LiveUSB de SliTaz) : Nom de la partition hôte de périphérique USB, ex : `SRC_FILE=/dev/sdb1`
     - iso (Image ISO de SliTaz) : Nom du fichier ISO, ex : `SRC_FILE=~/slitaz.3.0.iso`
     - web (Image ISO sur le Web) : Nom de l'URL, ex : `SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso`. À noter que 3 URL sont prédéfinies : « stable », « cooking », « rolling », ex : `SRC_FILE=cooking` téléchargera la dernière cooking disponible sur le web
     - weboot : inutilisé
- Les variables décrivant la partition cible :
  1. *TGT_PARTITION : Le nom de la partition cible sur laquelle SliTaz sera installé ou mis à jour, ex : `TGT_PARTITION=/dev/hda3`
  2. TGT_FS : Si cette variable est renseignée, la partition cible sera formatée dans le système de fichiers indiqué, sinon, la partition sera nettoyée et le répertoire /home sera conservé, ex : `TGT_FS=ext3`
  3. TGT_HOME : Cette variable indique, si besoin est, le nom de la partition recevant le répertoire /home, ex : `TGT_HOME=/dev/hda5`
  4. TGT_HOME_FS : Si cette variable est renseignée, la partition /home sera formatée dans le système de fichiers indiqué, ex : `TGT_HOME_FS=ext2`
- Les paramètres du système :
  1. TGT_HOSTNAME : Nom du système, ex : `TGT_HOSTNAME=hd-slitaz`, par défaut `TGT_HOSTNAME=slitaz`
  2. TGT_ROOT_PWD : Mot de passe du super-utilisateur, ex : `TGT_ROOT_PWD=toor`, par défaut `TGT_ROOT_PWD=root`
  3. TGT_USER : Nom de l'utitisateur par défaut, ex : `TGT_USER=toto`, par défaut `TGT_USER=tux`
  4. TGT_USER_PWD : Mot de passe de l'utilisateur par défaut, ex : `TGT_USER_PWD=titi`, par défaut `TGT_USER_PWD=tux`
- Les variables de configuration du chargeur de démarrage (bootloader) :
  1. TGT_GRUB : Installation de GRUB (yes ou no), ex : `TGT_GRUB=yes`, par défaut `TGT_GRUB=no`
  2. TGT_WINBOOT : Si cette variable est renseignée, elle indique la partition contenant Windows™ pour mettre en place un Dual-boot. Elle peut être aussi positionnée à « auto », dans ce cas le dual-boot se fera sur la première partition Windows™ détectée, ex : `TGT_WINBOOT=auto`

À noter que seules les variables précédées d'une atérisque sont obligatoires, les autres sont optionnelles. Ainsi un fichier de paramètres minimaliste peut être le suivant :

    INST_TYPE=cdrom
    TGT_PARTITION=/dev/hda3

Ce fichier permettra une installation de SliTaz sur /dev/hda3, sans formatter la partition, à partir d'un LiveCD.

## COMMANDES

### new

Génère un fichier de paramètres autodocumenté, qui une fois édité suivant les besoins de l'utilisateur, permettra d'installer ou mettre à jour SliTaz sur disque dur.

    tazinst new /var/lib/tazinst.conf

### install

Lance l'installation de SliTaz en fonction des données présentes dans le fichier de paramètres. Si le formattage de la partition est demandé, toutes les données seront perdues. Si le disque n'est pas formatté, toutes les données sauf un répertoire /home existant seront effacées, ce répertoire /home sera gardé tel quel.

    tazinst install /var/lib/tazinst.conf

### upgrade

Lance la mise à jour de SliTaz en fonction des données présentes dans le fichier de paramètres. Les répertoires /home /etc /var/www seront conservés, tous les autres répertoires seront supprimés. Tout paquet ajouté à la configuration de votre ancien système SliTaz sera mis à jour à la condition qu'une connexion internet soit active.

    tazinst upgrade /var/lib/tazinst.conf

### showurl

Affiche l'URL complète des raccourcis prédéfinis : « stable », « cooking », « rolling ».

Note : Vous pouvez redéfinir ces raccourcis dans le fichier système : /etc/slitaz/tazinst.conf.

    tazinst showurl stable

### check

Vérifie que le fichier de paramètres ne contient pas d'erreurs.

    tazinst check /var/lib/tazinst.conf

### log

Affiche le contenu du fichier journal.

    tazinst log

### version

Affiche les informations de version.

    tazinst version

## FICHIER SYSTÈME DE CONFIGURATION

Le fichier système de configuration /etc/slitaz/tazinst.conf permet de changer les paramètres par défaut de tazinst. Pour utiliser des valeurs personnalisées pour les URL, répertoires et fichiers, ce fichier doit être créé et les variables suivantes modifiées :

- URLs prédéfinies :
  1. URL de la version stable actuelle :

         URL_STABLE="http://mirror.slitaz.org/iso/stable/slitaz-4.0.iso"

  2. URL de la version cooking :

         URL_COOKING="http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso"

  3. URL de la version rolling :

         URL_ROLLING="http://mirror.slitaz.org/iso/rolling/slitaz-core.iso"

- Points de montage :
  1. Point de montage de la partition Source :

         SOURCE_ROOT="/media/source"

  2. Point de montage de la partition Cible :

         TARGET_ROOT="/mnt/target"

- Debug et journal :
  1. Emplacement du fichier journal :

         LOG="/var/log/tazinst.log"

  2. Debugging : (non ⇒ 0, debug ⇒ 1)

         DEBUG=0

     Il est chaudement recommandé de définir `DEBUG=1` et de joindre le fichier journal resultant lors de l'envoi d'un rapport de bogue aux développeurs.

## MAINTENEURS

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