Manuel de Tazinst

NOM

Tazinst — Tiny autonomous zone installer manager

SYNTAXE

tazinst [--machine] [commande] <paramètre> <valeur> <fichier>

Les commandes s'appliquent à un fichier d'installation contenant les paramètres. Le fichier par défaut est ./tazinst.rc, un autre fichier peut être donné en dernier argument de chaque commande. Avec --machine, la sortie est constituée d'enregistrements lisibles par les interfaces (voir doc/protocol.txt).

DESCRIPTION

Tazinst est l'installateur disque dur ultra léger de SliTaz. Il installe SliTaz depuis le système live en cours (LiveCD ou clé LiveUSB) ou depuis une image ISO située sur l'un de vos disques.

Tazinst peut formater la partition cible (ext2, ext3, ext4 et plus, selon le système live). Le répertoire personnel peut résider sur une autre partition, elle aussi formattable. Tazinst peut installer le chargeur de démarrage GRUB2 pour machines BIOS et UEFI, ajouter une entrée dual-boot vers une partition Windows™ existante, ainsi que des entrées de secours lançant le système live en RAM ou SliTaz depuis le web.

Tazinst peut aussi mettre à jour un SliTaz déjà installé sur une partition, pratique lors d'un changement de version : réglages, /home et liste des paquets sont sauvegardés, la nouvelle version est installée, puis ils sont restaurés. Les paquets supplémentaires sont réinstallés dès qu'une connexion Internet est active.

Tazinst, écrit en script shell à partir de zéro, est compatible Ash de Busybox et Bash. Tazinst est distribué sous licence libre GNU GPL v3. L'installateur exige root : lancez-le avec su.

PARAMÈTRES

Tazinst réalise une installation sans surveillance à partir de quelques paramètres stockés dans le fichier d'installation. Les paramètres requis ne peuvent rester vides ; les autres sont optionnels. En mode upgrade, seul un sous-ensemble s'applique — lancez tazinst get settings pour lister les paramètres du mode en cours.

mode

Requis. Mode d'installation : install (installation neuve sur une partition) ou upgrade (mise à jour d'un SliTaz installé, en gardant réglages, utilisateurs et paquets). Tapez tazinst help mode pour lister les modes supportés.

media

Requis. Le support contenant les fichiers sources de SliTaz : cdrom (LiveCD de SliTaz), usb (clé LiveUSB de SliTaz) ou iso (image ISO sur un disque local). Seuls les supports présents sur votre système sont listés par tazinst list media.

source

Requis, sauf avec le support cdrom. La source SliTaz, selon media : avec usb, la partition de la clé USB live (tazinst list usb) ; avec iso, le fichier image ISO (tazinst list iso).

root_uuid

Requis. La partition sur laquelle SliTaz sera installé (ou le système SliTaz à mettre à jour). Tapez tazinst list uuid pour lister les partitions de vos disques.

root_format

Optionnel. Si renseigné, la partition cible est formatée avec le système de fichiers indiqué ; en cas de doute, choisissez ext4. Le formatage efface tout le contenu de la partition. Sans formatage, elle est vidée aussi, sauf /home. Tapez tazinst help root_format pour les systèmes supportés et tazinst list format pour ceux installés sur votre système.

home_uuid

Optionnel. Une partition séparée pour les fichiers personnels (/home), conservés lors des réinstallations et mises à jour. Laissez vide pour ne pas utiliser de partition séparée.

home_format

Optionnel. Si renseigné, la partition /home séparée est formatée. Laissez vide pour conserver ses fichiers — le formatage efface tout le contenu de la partition.

hostname

Requis. Le nom de la machine sur le réseau, slitaz par défaut. Il peut être changé après l'installation.

root_pwd

Optionnel. Mot de passe du super-utilisateur [root], root par défaut. L'administrateur root gère tout le système : choisissez un mot de passe robuste, avec chiffres et caractères spéciaux.

user_login

Requis. Nom du premier utilisateur, tux par défaut. Le premier utilisateur garde ses fichiers personnels dans /home/<utilisateur> et appartient au groupe audio.

user_pwd

Optionnel. Mot de passe du premier utilisateur, tux par défaut. Il doit être robuste si la machine accepte les connexions SSH.

bootloader

Optionnel. Installe un chargeur de démarrage : réglez-le à auto et GRUB2 lance SliTaz à l'allumage, sur machines BIOS et UEFI. Omettez-le (valeur vide) seulement si un autre chargeur gère ce disque : vous devrez le configurer pour lancer SliTaz. Tapez tazinst help bootloader pour lister les chargeurs supportés.

liveboot

Optionnel, exige un chargeur de démarrage. Ajoute une entrée au menu de démarrage lançant le système live en RAM, en secours. Prend auto (oui) ou une valeur vide (non). Cette entrée demandera le mot de passe root.

webboot

Optionnel, exige un chargeur de démarrage. Ajoute une entrée au menu de démarrage lançant SliTaz depuis Internet. Prend auto (oui) ou une valeur vide (non). Cette entrée demandera le mot de passe root.

winboot

Optionnel, exige un chargeur de démarrage. Ajoute une entrée au menu de démarrage lançant Windows : auto sélectionne la première partition Windows™ trouvée, ou indiquez une partition. Tapez tazinst list winboot pour voir les valeurs détectées par tazinst.

COMMANDES

new

Crée un nouveau fichier d'installation autodocumenté. Il présélectionne le format racine à ext4 et le chargeur à auto quand les outils sont disponibles. Refuse d'écraser un fichier existant.

Exemples :

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

set

Attribue une nouvelle valeur à un paramètre, puis la vérifie.

Exemples :

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

unset

Efface un paramètre.

Exemples :

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

get

Affiche la valeur d'un paramètre, ou de tous les paramètres sans argument. tazinst get settings liste les paramètres du mode en cours.

Exemples :

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

check

Vérifie un paramètre, ou tous les paramètres actifs sans argument. Avec --machine, affiche un enregistrement clé état message par paramètre (ok, warning, error).

Exemples :

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

describe

Décrit les paramètres que l'interface doit demander, dans l'ordre, à raison d'un enregistrement clé type requis actif valeur titre aide avertissement par paramètre. À relancer après chaque changement : types et drapeaux actifs suivent les valeurs (source avec un CD, format /home sans partition /home, entrées de démarrage sans chargeur).

Exemple :

tazinst describe

options

Liste les valeurs possibles d'un paramètre, à raison d'un enregistrement valeur intitulé par valeur. Une valeur vide est valide quand elle est listée (pas de formatage, pas de chargeur, pas de /home séparé...). Les paramètres texte et mot de passe n'ont pas d'options.

Exemple :

tazinst options root_format

plan

Montre ce que fera execute, pour une page de résumé : mode, source, formatage ou nettoyage, /home, nom de machine, utilisateur, chargeur et entrées de démarrage, à raison d'un enregistrement par action.

Exemple :

tazinst plan

help

Affiche une aide succinte sur un paramètre, ou sur tous les paramètres sans argument. Documente aussi les sources cdrom, usb et iso.

Exemple :

tazinst help mode

list

Liste les ressources système. Les ressources sont :

mode	Modes d'installation disponibles
media	Supports d'installation disponibles. Exemple : cdrom n'est pas listé sur les systèmes sans lecteur cdrom
usb	Partitions des disques USB
iso	Images ISO sur les disques locaux : /root, /home, et disques montés sur /media ou /mnt
uuid	Partitions de vos disques, avec système de fichiers et étiquette
partitions	Toutes les partitions, lisible par machine, avec taille, rôle et système détecté
format	Systèmes de fichiers installés
bootloader	Chargeurs de démarrage disponibles
partition_table	Schémas de table de partition des disques locaux
winboot	Partitions Windows™ amorçables

Exemples :

tazinst list
tazinst list media

execute

Effectue l'installation ou la mise à jour décrite par le fichier d'installation. Exige root, et refuse de tourner deux fois (fichier verrou). Si le formatage est demandé, toutes les données de la partition sont perdues ; sinon elle est vidée sauf un /home existant. En mise à jour, /etc /home /var/www sont gardés. Envoyez SIGTERM pour annuler ; le journal complet reste dans /var/log/tazinst.log et est copié sur le système installé. Avec --machine, diffuse des enregistrements progress pourcent message, info message et error code message, et sort 0 en cas de succès.

Exemples :

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

clean

Efface le fichier d'installation, les fichiers temporaires et le journal.

Exemples :

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

log

Affiche le contenu du fichier journal.

Exemple :

tazinst log

version

Affiche les informations de version.

Exemple :

tazinst version

usage

Affiche une aide succinte.

Exemple :

tazinst usage

Codes de sortie

1	Erreur de paramètres
2	Erreur de fichier d'installation
3	Erreur de source
4	Erreur de cible
5	Ressource manquante
6	Aucun système SliTaz à mettre à jour
7	Une autre instance tourne déjà
8	Erreur interne
9	Annulé par l'utilisateur

INTERFACES

Trois interfaces pilotent le moteur tazinst étape par étape via son protocole machine (doc/protocol.txt) : étapes, valeurs et vérifications viennent toutes de tazinst, si bien qu'un paramètre ajouté au moteur apparaît sans changer les interfaces. Toutes exigent root et acceptent un fichier d'installation optionnel :

slitaz-installer [fichier]
tazinst-tui [fichier]
tazinst-gtk [fichier]

Sans argument, elles créent un fichier d'installation neuf sous /tmp (effacé en sortie, il contient des mots de passe) et guident à travers chaque étape jusqu'à une page de résumé — dernière chance d'annuler ou de revenir en arrière. Avec un fichier prêt donné en argument, elles l'ouvrent directement sur son résumé.

• slitaz-installer : interface dialog, en script shell.
• tazinst-tui : interface ncurses en C (src/), thème orange SliTaz, barre de progression pendant l'installation.
• tazinst-gtk : interface GTK3 en C (src/), pour le live graphique ; exige root, lancez-la avec subox.

EXEMPLES

Installation

Installer SliTaz sur une partition de votre disque dur depuis une image ISO. La partition racine n'est pas formatée : toutes les données sauf un répertoire /home existant sont effacées.

1. Créez un fichier d'installation :

   # tazinst new

2. Réglez le mode sur install :

   # tazinst set mode install

3. Utilisez une ISO comme source :

   # tazinst set media iso

4. Sélectionnez l'image ISO :

   # tazinst set source ~/slitaz-rolling.iso

5. Sélectionnez la partition d'installation de SliTaz :

   # tazinst set root_uuid /dev/sda1

6. Installez un chargeur de démarrage :

   # tazinst set bootloader auto

7. Vérifiez, exécutez, nettoyez :

   # tazinst check
   # tazinst execute
   # tazinst clean

Installation complexe

Installer SliTaz avec une partition /home séparée et un dual-boot Windows™. Les partitions racine et /home sont toutes deux formatées (toutes les données existantes seront perdues).

1. Créez un fichier d'installation :

   # tazinst new

2. Réglez le mode sur install :

   # tazinst set mode install

3. Utilisez une LiveUSB comme source :

   # tazinst set media usb

4. Sélectionnez la partition de la clé USB live :

   # tazinst set source /dev/sdb1

5. Sélectionnez la partition d'installation de SliTaz :

   # tazinst set root_uuid /dev/sda1

6. Formatez / en ext4 :

   # tazinst set root_format ext4

7. Utilisez une partition /home séparée :

   # tazinst set home_uuid /dev/sda2

8. Formatez /home en ext4 :

   # tazinst set home_format ext4

9. Installez un chargeur et un dual-boot Windows™ :

   # tazinst set bootloader auto
   # tazinst set winboot auto

10. Vérifiez, exécutez, nettoyez :

    # tazinst check
    # tazinst execute
    # tazinst clean

Mise à jour

Mettre à jour un système SliTaz déjà installé. /etc /home /var/www sont gardés, tous les autres répertoires sont remplacés. Les paquets supplémentaires sont mis à jour dès qu'une connexion Internet est active.

1. Créez un fichier d'installation :

   # tazinst new

2. Réglez le mode sur upgrade :

   # tazinst set mode upgrade

3. Utilisez une ISO comme source :

   # tazinst set media iso

4. Sélectionnez l'image ISO :

   # tazinst set source ~/slitaz-rolling.iso

5. Sélectionnez la partition du SliTaz à mettre à jour :

   # tazinst set root_uuid /dev/sda1

6. Vérifiez, exécutez, nettoyez :

   # tazinst check
   # tazinst execute
   # tazinst clean

Astuces

1. Tous les paramètres ne s'appliquent pas à chaque mode. Listez ceux de votre mode :

   # tazinst get settings

2. Prévisualisez l'installation avant de la lancer :

   # tazinst plan

FICHIERS

FICHIER D'INSTALLATION

Les paramètres sont enregistrés dans le fichier d'installation, puis utilisés par tazinst pour une installation sans surveillance. Le fichier par défaut est ./tazinst.rc, mais un autre nom peut être donné en paramètre. Le fichier d'installation est autodocumenté. La commande clean l'efface.

FICHIER SYSTÈME

Le fichier /etc/slitaz/tazinst.conf présélectionne les valeurs par défaut de tazinst : nom de machine, mots de passe, utilisateur et liste des images SliTaz connues (URL_ISO). Tout paramètre peut être présélectionné en ajoutant son nom en majuscules avec la valeur voulue.

Exemple :

Pour présélectionner le nom du système et l'utilisateur de chaque installation :

HOSTNAME="slitaz"
USER_LOGIN="tux"

FICHIER JOURNAL

Le fichier /var/log/tazinst.log contient le journal d'installation et est copié sur le système installé. La commande clean l'efface.

MAINTENEURS

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