archinstall

Project status

Use case

This script provides a full unattended way to install ArchLinux from any live environment. You can create your own linux distribution based on the rolling released ArchLinux. A rock solid decorator pattern allows to automate a fully unattended individual installation process.

Quick-Start

Simply load the newest version from:

archinstall

>>> curl https://goo.gl/YbxT3F >archinstall.sh && chmod +x archinstall.sh

oder ohne Link-Shortener:

>>> curl \
    https://torben.website/archinstall/data/distributionBundle/archinstall.sh \
        >archinstall.sh && \
    chmod +x archinstall.sh

neuste unstable Version:

>>> curl \
    https://raw.githubusercontent.com/thaibault/archinstall/main/archinstall.sh \
        >archinstall.sh && \
    chmod +x archinstall.sh

archinstall ist das zentrale Modul um eine Reihe von Aufgaben im Zuge der Vorbereitung, Installation, Konfiguration oder Manipulieren eines "Linux from Scratch" durchzuführen.

Das Modul kann im einfachsten Fall (z.B. von einer beliebigen Live-Linux-Umgebung) gestartet werden. Zu beachten ist, dass die Installation von einem UEFI-System empfohlen wird, da dadurch entsprechende Boot-Einträge automatisch gesetzt werden können. Ein Bootloader wird nicht mit installiert und ist nicht notwendig, um das System zu booten.

>>> ./archinstall.sh

In diesem Fall werden alle benötigten Informationen zur Einrichtung (nur Hostname) des Systems vor Beginn des Installations Prozesses interaktiv abgefragt. Zu Beachten ist: ohne zusätzliche Parameter gibt das Modul keinen Feedback über den aktuellen Zustand des Installations Vorgangs. Mit:

>>> ./archinstall.sh --verbose

bekommt man einen etwas geschwätzigeren Installationsvorgang. Mit:

>>> ./archinstall.sh --verbose --debug

werden alle Ausgaben jeglicher verwendeten Subprogramme mit ausgegeben.

Alle Parameter wie Installations haben Standardwerte. So wird im obigen Fall einfach in das aktuelle Verzeichnis ein Ordner mit dem Programmnamen erstellt und darin das Betriebssystem installiert (./archinstall/). Möchte man eine unbeaufsichtigte Installation:

>>> ./archinstall.sh --auto-partitioning --host-name testSystem

Install to blockdevice

Im typischen Fall will man von einer Live-CD booten um das System auf einer Festplatte oder Partition zu installieren. Hierbei müssen folgende Aufgaben erfüllt werden.

• Einrichtung einer Internet Verbindung (siehe auch Abschnitt "Offline Installation")
• Partitionierung der Ziel Festplatte
• Formatierung der Ziel Partitionen
• Aufbauen der Dateisystemstruktur
• Konfiguration des Betriebssystems
• Installation und Einrichtung eines Boot-Loaders

Alle Aufgaben bis auf die Einrichtung der Internet Verbindung (wird in der Regel von der Host Umgebung geregelt) könne mit archinstall automatisiert durchgeführt werden. Will man z.B auf das Block Device "/dev/sdb" installieren und sich nicht selber um die Partitionierung kümmern und den kompletten verfügbaren Platz für das Haupt System verwenden (es soll also keine Swap- oder Daten Partition erstellt werden). sieht das z.B. so aus:

>>> ./archinstall.sh --auto-partitioning --target /dev/sdb

Auf diese Weise wird eine uefi Boot-Partition mit 2 GigaByte eingerichtet. Der restliche Platz wird für die Systempartition eingesetzt. Sind noch weitere Partitionen gewünscht kann man diese während der Installation durch weglassen des entsprechenden Parameters selber konfigurieren. Die erste Partition wird dann als Boot-Partition und die Zweite als Systempartition betrachtet. Weitere Partitionen werden ignoriert. Manuelle Partitionierung:

>>> ./archinstall.sh --target /dev/sdb

Archinstall erstellt alle Partition mit Labels sowohl in der Partitionstabelle als auf der Partition selbst. Um dieses Verhalten zu individualisieren, können folgende Optionen genutzt werden:

>>> ./archinstall.sh \
    --boot-partition-label uefiBoot \
    --system-partition-label system

Install to partition

Um z.B. aus einem Produktivsystem heraus eine alternative Linux Distribution auf eine weitere Partition zu installieren kann einfach folgender Befehl verwendet werden:

>>> ./archinstall.sh --target /dev/sdb2

Hier wird auf die zweite Partition des zweiten Block Devices installiert. archinstall versucht bei der Installation auf ein Blockdevice stets einen entsprechenden Uefi-Boot-Eintrag für den Kernel mit einem Standard Initramfs und einem Ausweich-Initiramfs zu konfigurieren. Die folgenden Parameter definieren dessen Label:

>>> ./archinstall.sh \
    --boot-entry-label archLinux \
    --fallback-boot-entry-label archLinuxFallback \
    --target /dev/sdb2

Install to folder

Um archinstall für komplexere Szenarien zu verwenden oder nachträgliche Manipulationen vorzunehmen ist es sinnvoll zunächst in einen Ordner zu installieren. Siehe hierzu "archinstall with Decorator Pattern", "makeXBMCLinux", "makeRamOnlyLinux" oder "makeSquashLinux" bzw. das Projekt "archinstallWrapperTemplate".

Dieser Befehl installiert ein vollständiges System in den eigenen Home-Ordner "test" (siehe auch Installation ohne root Rechte).

>>> ./archinstall.sh --target ~/test

Automatic configuration

archinstall konfiguriert das neu eingerichtete System vollautomatisch. Folgende Tasks wurden automatisiert:

• Tastaturlayout einstellen
• Einrichten der richtigen Zeit Zone
• Setzen des Hostnames
• Setzen des default root Passworts nach "root"
• Erstellen eines Benutzers bzw. Benutzerordner. Das Passwort wird initial wie der Name des Benutzers gesetzt.
• dhcp Dienst für alle Netzwerk-Interfaces einrichten (siehe automatisches Einrichten von Diensten)
• Installation der Basis Programme (siehe automatische Installation von Programmen)
• Einrichten der Signaturen für den Paketmanager "Pacman", um vertrauenswürdige Pakete erhalten zu können.
• Einrichten aller in der nähe liegenden Server um schnelle Packet Updates und Paketinstallationen zu gewährleisten.
• Einrichten der richtigen Paketquellen abhängig von der aktuellen CPU Architektur.

Will man hierauf selber Einfluss nehmen, gibt es folgende Möglichkeiten:

>>> ./archinstall.sh \
    --additional-packages python vim \
    --country-with-mirrors Germany \
    --cpu-architecture x86_64 \
    --host-name test \
    --keyboard-layout de-latin1 \
    --local-time /Europe/London \
    --needed-services sshd dhcpcd apache \
    --prevent-using-pacstrap \
    --user-names test

Um die einzelnen Konfigurationsparameter zu verstehen empfiehlt sich ein Blick auf:

>>> ./archinstall.sh --help

zu werfen.

Application Interface

Viele nützlich Umgebungsvariablen und Funktionen können mit

>>> source archinstall.sh --load-environment

geladen werden. Um eine Übersicht zu erhalten sollte man sie die API-Dokumentation anschauen.

Options

archinstall stellt ein Alphabet voller Optionen zur Verfügung. Während bisher zum einfachen Verständnis immer Long-Options verwendet wurden, gibt es für jede Option auch einen Shortcut.

>>> ./archinstall.sh --user-names mustermann --host-name lfs

ist äquivalent zu:

>>> ./archinstall.sh -u mustermann -n lfs

Alle Optionen bis auf "--host-name" und "--auto-partitioning" haben Standardwerte. Diese beiden werden sofern nicht von vorne herein angegeben interaktiv abgefragt. Alle Standardwert können mit Hilfe von:

>>> ./archinstall.sh -h

oder

>>> ./archinstall.sh --help

oder

>>> ./archinstall.sh --keyboard-layout de-latin1 -h

eingesehen werden. Letzteres macht Sinn, da sich Standardwerte aufgrund schon ermittelten Informationen verändern können. So wird der Standardwert von "--key-map-configuration="KEYMAP=de-latin1\nFONT=Lat2-Terminus16\nFONT_MAP=" nach Eingabe von

>>> ./archinstall.sh --keyboard-layout us

zu: "--key-map-configuration="KEYMAP=us\nFONT=Lat2-Terminus16\nFONT_MAP=".

Der Standardwert von "--cpu-architecture" entspricht beispielsweise immer der Architektur des aktuellen Systems, um Konfigurationsaufwand zu minimieren.

Man kann Optionen die mehrere Werte annehmen auch mehrfach referenzieren. So hat:

>>> ./archinstall.sh \
    --additional-packages ssh \
    --additional-packages vim \
    -g python

den gleichen Effekt wie:

>>> ./archinstall.sh --additional-packages ssh vim python

Install offline

archinstall erstellt bei jeder Installation automatisch einen Paket-Cache, um weitere Installationen zu beschleunigen. Ist dieser einmal erstellt oder wird dieser zusammen mit dem archinstall (z.b. auf einem usb-stick) ausgeliefert kann Offline installiert werden.

Selbst wenn mit einem bereits vorhandenem pacstrap installiert wird, wird dieser temporär kopiert, gepatched und anschließend offlinefähig ausgeführt!

Bei Offline Installation müssen natürlich alle zusätzlich ausgewählten Pakete im Package Cache vorhanden sein. Ist dies nicht der Fall wird archinstall versuchen diese nach zu laden und im Offline-Fall einen Fehler zurückgeben.

Install without having root permissions

Prinzipiell ist es möglich auch ohne root Rechte ein System aufzusetzen. Hierbei werden jedoch folgende Einschnitte gemacht:

• Die Programm "fakeroot" und "fakechroot" müssen zusätzlich installiert sein.
• Ein bereits installiertes Pacstrap kann nicht eingesetzt werden
• Zusätzlich erstellten Benutzer kann während der Installation kein automatisch erstellter Home-Ordner geliefert werden, da die Rechte oder root nicht richtig gesetzt werden könnten.
• Es kann nur in "Ordner" (bzw. siehe nächsten Punkt) installiert werden.
• Das System wird in ein tar-Archiv ohne Speicherung entsprechender Datei Rechte Attribute gepackt.
• Das Tar Archiv muss als "root" entpackt werden bevor das Ergebnis verwendet oder fehlerfrei gebootet werden kann.

Useful tips and debugging informations

Während der Entwicklung haben sich eine Reihe von Optionen bewährt um Fehler bei der Entwicklung von Wrappern zu finden.

Die Option "--prevent-using-pacstrap" oder "-p" verhindert ein bereits installierten Pacman für die Installation zu verwenden. Dies ist notwendig wenn man sein Pacman so konfiguriert hat, das z.B. Pakete wie der Kernel oder Pacman von manipulierten User Repositories abhängen. Mit "--prevent-using-pacstrap" wird eine neue Version von Pacman in einer Change-Root-Umgebung ausgeführt.

Möchte man die Pakete "base-devel", "sudo" und "python" haben, geht das mit dem Shortcut: "--install-common-additional-packages" oder "-z".

Will man eine beliebige Liste von Paketen integrieren:

>>> ./archinstall.sh --additional-packages ssh python2 vim

Sollen Dienste schon beim ersten Start automatisch gestartet werden:

>>> ./archinstall.sh --needed-services sshd dhcpcd

Um die Installation zu beschleunigen kann auf ein Cache verwiesen werden:

>>> ./archinstall.sh --cache-path /var/cache/archinstall/