Tazinst-Handbuch

NAME

Tazinst — Tiny autonomous zone installer manager (Installationsverwaltung für SliTaz)

SYNTAX

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

Die Befehle arbeiten mit einer Installationsdatei, welche die Installationseinstellungen enthält. Standardmäßig ist dies ./tazinst.rc; eine andere Datei kann bei jedem Befehl als letztes Argument angegeben werden. Mit --machine erfolgt die Ausgabe als maschinenlesbare Datensätze für Frontends (siehe doc/protocol.txt).

BESCHREIBUNG

Tazinst ist ein schlankes Installationsprogramm, das SliTaz auf eine Festplatte installiert, und zwar aus dem laufenden Live-System (LiveCD oder LiveUSB-Stick) heraus oder aus einem ISO-Abbild auf einem Ihrer Datenträger.

Tazinst kann die Zielpartition formatieren (ext2, ext3, ext4 und weitere, je nachdem, was auf dem Live-System installiert ist). Das Home-Verzeichnis kann auf einer anderen Partition liegen, die ebenfalls formatiert werden kann. Tazinst kann den Bootloader GRUB2 für BIOS- und UEFI-Rechner installieren, einen Dual-Boot-Eintrag für eine vorhandene Windows™-Partition hinzufügen sowie Rettungseinträge, die das Live-System aus dem Arbeitsspeicher oder SliTaz aus dem Internet starten.

Tazinst kann außerdem ein bereits auf einer Festplattenpartition installiertes SliTaz aktualisieren, was bei einem Versionswechsel praktisch ist: Einstellungen, /home und die Paketliste werden gesichert, die neue Version wird installiert, und anschließend wird alles wiederhergestellt. Zusätzliche Pakete werden über eine aktive Internetverbindung neu installiert.

Tazinst wurde von Grund auf als Shell-Skript geschrieben und ist mit Busybox Ash und Bash kompatibel. Tazinst steht unter der GNU GPL v3. Das Installationsprogramm benötigt root-Rechte: Starten Sie es mit su.

EINSTELLUNGEN

Tazinst führt eine unbeaufsichtigte Installation anhand weniger Einstellungen durch, die in der Installationsdatei gespeichert sind. Erforderliche Einstellungen dürfen nicht leer bleiben; alle anderen sind optional. Im Modus upgrade gilt nur ein Teil davon — mit tazinst get settings lassen sich die Einstellungen des aktuellen Modus auflisten.

mode

Erforderlich. Der Installationsmodus: install (Neuinstallation auf einer Partition) oder upgrade (Aktualisierung eines installierten SliTaz unter Beibehaltung von Einstellungen, Benutzern und Paketen). Mit tazinst help mode werden die unterstützten Modi aufgelistet.

media

Erforderlich. Der Datenträger mit den SliTaz-Quelldateien: cdrom (SliTaz-LiveCD), usb (SliTaz-LiveUSB-Stick) oder iso (ISO-Abbild auf einem lokalen Datenträger). tazinst list media listet nur die Datenträger auf, die auf Ihrem System verfügbar sind.

source

Erforderlich, außer beim Datenträger cdrom. Die SliTaz-Quelle, abhängig von media: bei usb die Partition des Live-USB-Sticks (tazinst list usb); bei iso die ISO-Abbilddatei (tazinst list iso).

root_uuid

Erforderlich. Die Partition, auf die SliTaz installiert wird (bzw. das zu aktualisierende SliTaz-System). Mit tazinst list uuid werden die Partitionen Ihrer Datenträger aufgelistet.

root_format

Optional. Wenn gesetzt, wird die Zielpartition mit dem angegebenen Dateisystem formatiert; wählen Sie im Zweifelsfall ext4. Beim Formatieren wird alles auf der Partition gelöscht. Ohne Formatierung wird sie ebenfalls geleert, mit Ausnahme von /home. Mit tazinst help root_format erhalten Sie die unterstützten Dateisysteme und mit tazinst list format die auf Ihrem System installierten.

home_uuid

Optional. Eine eigene Partition für persönliche Dateien (/home), die bei Neuinstallationen und Aktualisierungen erhalten bleibt. Leer lassen, wenn keine eigene Partition verwendet werden soll.

home_format

Optional. Wenn gesetzt, wird die eigene /home-Partition formatiert. Lassen Sie die Einstellung leer, um die darauf befindlichen Dateien zu behalten — beim Formatieren wird alles auf der Partition gelöscht.

hostname

Erforderlich. Der Name des Rechners im Netzwerk, standardmäßig slitaz. Er kann nach der Installation geändert werden.

root_pwd

Optional. Kennwort des Superusers [root], standardmäßig root. Der Administrator root verwaltet das gesamte System: Wählen Sie ein sicheres Kennwort mit Ziffern und Sonderzeichen.

user_login

Erforderlich. Name des ersten Benutzers, standardmäßig tux. Der erste Benutzer legt seine persönlichen Dateien in /home/<user> ab und gehört der Gruppe audio an.

user_pwd

Optional. Kennwort des ersten Benutzers, standardmäßig tux. Es muss sicher sein, wenn der Rechner SSH-Verbindungen annimmt.

bootloader

Optional. Einen Bootloader installieren: Setzen Sie den Wert auf auto, dann startet GRUB2 SliTaz beim Einschalten, auf BIOS- und UEFI-Rechnern. Lassen Sie dies nur weg (leerer Wert), wenn ein anderer Bootloader diesen Datenträger verwaltet: Sie müssen diesen dann selbst so einrichten, dass er SliTaz startet. Mit tazinst help bootloader werden die unterstützten Bootloader aufgelistet.

liveboot

Optional, erfordert einen Bootloader. Fügt einen Eintrag im Startmenü hinzu, der das Live-System zur Rettung im Arbeitsspeicher startet. Akzeptiert auto (ja) oder einen leeren Wert (nein). Der Eintrag fragt nach dem root-Kennwort.

webboot

Optional, erfordert einen Bootloader. Fügt einen Eintrag im Startmenü hinzu, der SliTaz aus dem Internet startet. Akzeptiert auto (ja) oder einen leeren Wert (nein). Der Eintrag fragt nach dem root-Kennwort.

winboot

Optional, erfordert einen Bootloader. Fügt einen Eintrag im Startmenü hinzu, der Windows startet: auto wählt die erste gefundene Windows™-Partition, alternativ geben Sie eine Partition an. Mit tazinst list winboot sehen Sie die Werte, die tazinst erkennt.

BEFEHLE

new

Erstellt eine neue, selbstdokumentierende Installationsdatei. Als Standard werden das Format der Wurzelpartition auf ext4 und der Bootloader auf auto gesetzt, sofern die Werkzeuge verfügbar sind. Eine vorhandene Datei wird nicht überschrieben.

Beispiele:

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

set

Weist einer Einstellung einen neuen Wert zu und prüft ihn anschließend.

Beispiele:

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

unset

Leert eine Einstellung.

Beispiele:

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

get

Gibt den Wert einer Einstellung aus, ohne Argument den aller Einstellungen. tazinst get settings listet die Einstellungen auf, die für den aktuellen Modus gelten.

Beispiele:

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

check

Prüft eine Einstellung auf Fehler, ohne Argument alle aktiven Einstellungen. Mit --machine wird pro Einstellung ein Datensatz key status message ausgegeben (ok, warning, error).

Beispiele:

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

describe

Beschreibt der Reihe nach die Einstellungen, die ein Frontend abfragen muss, mit einem Datensatz key type required active value label help warning pro Einstellung. Führen Sie den Befehl nach jeder Änderung erneut aus: Typen und Aktiv-Kennzeichen richten sich nach den Werten (Quelle bei einer CD, Format von /home ohne /home-Partition, Starteinträge ohne Bootloader).

Beispiel:

tazinst describe

options

Listet die Werte auf, die eine Einstellung annehmen kann, mit einem Datensatz value label pro Wert. Ein leerer Wert ist gültig, wenn er aufgeführt ist (keine Formatierung, kein Bootloader, keine eigene /home-Partition …). Text- und Kennworteinstellungen haben keine Optionen.

Beispiel:

tazinst options root_format

plan

Zeigt für eine Übersichtsseite an, was execute tun wird: Modus, Quelle, Formatierung oder Leeren, /home, Rechnername, Benutzer, Bootloader und Starteinträge, mit einem Datensatz pro Aktion.

Beispiel:

tazinst plan

help

Gibt eine Kurzhilfe zu einer Einstellung aus, ohne Argument zu allen Einstellungen. Beschreibt außerdem die Quellen cdrom, usb und iso.

Beispiel:

tazinst help mode

list

Listet Systemressourcen auf. Folgende Ressourcen gibt es:

mode	Verfügbare Installationsmodi
media	Verfügbare Installationsdatenträger. Beispiel: cdrom wird auf Systemen ohne CD-Laufwerk nicht aufgeführt
usb	Partitionen von USB-Datenträgern
iso	ISO-Abbilder auf lokalen Laufwerken: /root, /home sowie unter /media oder /mnt eingehängte Datenträger
uuid	Partitionen Ihrer Datenträger, mit Dateisystem und Bezeichnung
partitions	Alle Partitionen, maschinenlesbar, mit Größe, Rolle und erkanntem System
format	Installierte Dateisysteme
bootloader	Verfügbare Bootloader
partition_table	Partitionstabellen-Schemata der lokalen Datenträger
winboot	Startfähige Windows™-Partitionen

Beispiele:

tazinst list
tazinst list media

execute

Führt die in der Installationsdatei beschriebene Installation oder Aktualisierung durch. Erfordert root-Rechte und verweigert einen zweiten gleichzeitigen Lauf (Sperrdatei). Wenn Sie das Formatieren gewählt haben, gehen alle Daten auf der Partition verloren; andernfalls wird sie geleert, mit Ausnahme eines vorhandenen /home. Bei einer Aktualisierung bleiben /etc /home /var/www erhalten. Zum Abbrechen senden Sie SIGTERM; das vollständige Protokoll bleibt in /var/log/tazinst.log erhalten und wird in das installierte System kopiert. Mit --machine werden die Datensätze progress percent message, info message und error code message fortlaufend ausgegeben, und bei Erfolg wird mit 0 beendet.

Beispiele:

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

clean

Entfernt die Installationsdatei, die temporären Dateien und die Protokolldatei.

Beispiele:

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

log

Zeigt den Inhalt der letzten Protokolldatei an und beendet sich.

Beispiel:

tazinst log

version

Gibt die Versionsinformationen aus und beendet sich.

Beispiel:

tazinst version

usage

Gibt eine Kurzhilfe aus und beendet sich.

Beispiel:

tazinst usage

Rückgabewerte

1	Fehler in den Parametern
2	Fehler in der Installationsdatei
3	Fehler bei der Quelle
4	Fehler beim Ziel
5	Fehlende Ressource
6	Kein zu aktualisierendes SliTaz-System
7	Eine andere Instanz läuft bereits
8	Interner Fehler
9	Vom Benutzer abgebrochen

FRONTENDS

Drei Frontends steuern das tazinst-Backend Schritt für Schritt über dessen Maschinenprotokoll (doc/protocol.txt): Schritte, Werte und Prüfungen stammen alle aus tazinst, sodass eine im Backend hinzugefügte Einstellung ohne Änderung am Frontend erscheint. Alle benötigen root-Rechte und akzeptieren optional eine Installationsdatei:

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

Ohne Argument erstellen sie eine neue Installationsdatei unter /tmp (wird beim Beenden gelöscht, da sie Kennwörter enthält) und führen durch alle Schritte bis zu einer Übersichtsseite — der letzten Gelegenheit, abzubrechen oder zurückzugehen. Wird eine fertige Installationsdatei übergeben, öffnen sie diese direkt auf ihrer Übersicht.

• slitaz-installer: dialog-Frontend, Shell-Skript.
• tazinst-tui: ncurses-Frontend in C (src/), oranges SliTaz-Design, Fortschrittsbalken während der Installation.
• tazinst-gtk: GTK3-Frontend in C (src/), für den Live-Desktop; benötigt root-Rechte, starten Sie es mit subox.

BEISPIELE

Installation

SliTaz aus einem ISO-Abbild auf eine Partition Ihrer Festplatte installieren. Die Wurzelpartition wird nicht formatiert: Alle Daten außer einem vorhandenen Verzeichnis /home werden entfernt.

1. Eine Installationsdatei erstellen:

   # tazinst new

2. Den Modus auf Installation setzen:

   # tazinst set mode install

3. Ein ISO-Abbild als Quelle verwenden:

   # tazinst set media iso

4. Das ISO-Abbild auswählen:

   # tazinst set source ~/slitaz-rolling.iso

5. Die Partition auswählen, auf die SliTaz installiert werden soll:

   # tazinst set root_uuid /dev/sda1

6. Einen Bootloader installieren:

   # tazinst set bootloader auto

7. Einstellungen prüfen, ausführen, aufräumen:

   # tazinst check
   # tazinst execute
   # tazinst clean

Komplexe Installation

SliTaz mit einer eigenen /home-Partition und Windows™-Dual-Boot installieren. Sowohl die Wurzel- als auch die /home-Partition werden formatiert (alle vorhandenen Daten gehen verloren).

1. Eine Installationsdatei erstellen:

   # tazinst new

2. Den Modus auf Installation setzen:

   # tazinst set mode install

3. Einen LiveUSB-Stick als Quelle verwenden:

   # tazinst set media usb

4. Die Partition des Live-USB-Sticks auswählen:

   # tazinst set source /dev/sdb1

5. Die Partition auswählen, auf die SliTaz installiert werden soll:

   # tazinst set root_uuid /dev/sda1

6. / als ext4 formatieren:

   # tazinst set root_format ext4

7. Eine eigene /home-Partition verwenden:

   # tazinst set home_uuid /dev/sda2

8. /home als ext4 formatieren:

   # tazinst set home_format ext4

9. Einen Bootloader und Windows™-Dual-Boot installieren:

   # tazinst set bootloader auto
   # tazinst set winboot auto

10. Prüfen, ausführen, aufräumen:

    # tazinst check
    # tazinst execute
    # tazinst clean

Aktualisierung

Ein bereits installiertes SliTaz-System aktualisieren. /etc /home /var/www bleiben erhalten, alle anderen Verzeichnisse werden ersetzt. Zusätzliche Pakete werden über eine aktive Internetverbindung aktualisiert.

1. Eine Installationsdatei erstellen:

   # tazinst new

2. Den Modus auf Aktualisierung setzen:

   # tazinst set mode upgrade

3. Ein ISO-Abbild als Quelle verwenden:

   # tazinst set media iso

4. Das ISO-Abbild auswählen:

   # tazinst set source ~/slitaz-rolling.iso

5. Die Partition mit dem zu aktualisierenden SliTaz auswählen:

   # tazinst set root_uuid /dev/sda1

6. Prüfen, ausführen, aufräumen:

   # tazinst check
   # tazinst execute
   # tazinst clean

Tipps

1. Nicht alle Einstellungen gelten in jedem Modus. Listen Sie die Einstellungen Ihres Modus auf:

   # tazinst get settings

2. Zeigen Sie die Installation vorab an, bevor Sie sie ausführen:

   # tazinst plan

DATEIEN

INSTALLATIONSDATEI

Die Einstellungen werden in der Installationsdatei gespeichert und dann von tazinst für eine unbeaufsichtigte Installation verwendet. Standardmäßig ist dies ./tazinst.rc, optional kann jedoch ein Dateiname als Parameter angegeben werden. Die Installationsdatei ist selbstdokumentierend. Der Befehl clean löscht sie.

SYSTEMDATEI

Die Konfigurationsdatei /etc/slitaz/tazinst.conf legt Standardwerte für tazinst fest: Rechnername, Kennwörter, Benutzername und die Liste der bekannten SliTaz-Abbilder (URL_ISO). Jede Einstellung kann vorbelegt werden, indem ihr Name in Großbuchstaben mit dem gewünschten Wert eingetragen wird.

Beispiel:

Um den Systemnamen und den Benutzer für jede Installation vorzubelegen:

HOSTNAME="slitaz"
USER_LOGIN="tux"

PROTOKOLLDATEI

Die Datei /var/log/tazinst.log enthält das Installationsprotokoll und wird in das installierte System kopiert. Der Befehl clean löscht sie.

BETREUER

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