Installation

Zum Inhaltsverzeichnis

2.1 Voraussetzungen#

• Linux: x86-64-Rechner mit glibc. Für LVM-Snapshots werden Root-Rechte und die lvm2-Werkzeuge gebraucht.
• Windows: Windows 10 oder 11 bzw. Windows Server, Administratorrechte für die Sicherung von Volumes und Platten (VSS).
• Backup-Server: ein Linux-Rechner mit ausreichend Speicherplatz und einem erreichbaren TCP-Port (Standard 9990).

2.2 Installation mit bkp_setup#

bkp_setup ist das Installationsprogramm. Es ist klein und eigenständig (Linux: statisch gelinkt, braucht nur libc; Windows: aegisgrid-setup.exe), lädt die gewählten Komponenten vom Update-Server, installiert sie und richtet sie ein. Adresse, Kanal und öffentlicher Signaturschlüssel sind beim Bau eingebaut und lassen sich mit Optionen überschreiben. Installiert wird nur, was im signierten Komponenten-Katalog des Herausgebers steht.

Voreinstellungen: --preset client (core, agent, restore), --preset server (core, target, maintenance, monitor), --preset all. Abhängigkeiten werden automatisch mitgewählt. Der Updater aktualisiert danach nur die installierten Komponenten.

2.2.1 Linux: Text-Assistent und Silent-Modus#

# als root im Terminal: der Assistent fragt Komponenten, Update-Server, Client- und Server-Einstellungen
./bkp_setup-linux-x86_64

# ohne Fragen (Skript, Konfigurationsverwaltung)
./bkp_setup --silent --accept-eula --preset client \
    --client-server backup.example.com:9990 --client-dir vm1 --client-cert /root/target.crt --client-key-file /root/vm1.key
./bkp_setup --silent --accept-eula --preset server --configure-server \
    --server-storage /srv/backups --server-dirs vm1,vm2 --server-cn backup.example.com --enable-target-api

Eine neue Installation verlangt die Annahme der Lizenzbedingungen: Der Assistent zeigt sie vor der Auswahl der Komponenten, ohne Fragen gilt --accept-eula (in der Antwortdatei die Zeile accept-eula); --show-eula gibt den Text aus. Das Setup hält die Annahme mit Fassung, Sprache und Zeitpunkt in /etc/bkp/eula-accepted.txt fest (unter Windows im Konfigurationsordner). Ändern, Reparieren, Deinstallieren und Updates fragen nicht erneut.

--answers <datei> liest schlüssel = wert-Zeilen mit den Optionsnamen ohne Striche. Die Installation legt /opt/aegisgrid/versions/<v> mit dem Link current an (wie der Updater), verlinkt die Programme nach /usr/local/bin, richtet den systemd-Timer des Updaters ein (sonst cron) und schreibt /etc/bkp/updater.conf. Für den Client legt sie das Server-Zertifikat und die Key-Datei in /etc/bkp ab, prüft die Verbindung (bkp_restore --list) und zeigt einen fertigen bkp_agent-Aufruf. Mit --configure-server erzeugt sie für bkp_target ein Zertifikat, das Speicherverzeichnis, die ACL mit dem ersten API-Key (wird nur einmal angezeigt) und eine systemd-Unit. --enable-target-api (im Assistenten die Frage nach der Target-API) schaltet zusätzlich die Target-API ein und legt den ersten Zugang für die Target-Konsole an (Name target-konsole, anderer mit --target-api-token <name>, Rolle admin); Port, Fingerprint und Token zeigt der Bericht am Ende (das Token nur einmal). Die Protokollzeilen der Installation schreibt der Assistent ins Systemprotokoll statt auf den Bildschirm; gab es Warnungen, nennt er am Ende ihre Zahl (Einzelheiten: journalctl -t bkp_setup, mit --no-syslog stehen sie nach dem Bericht).

2.2.2 Windows: Assistent#

aegisgrid-setup.exe ohne Optionen öffnet einen Assistenten (Willkommen, Lizenzbedingungen, Komponenten, Update-Server, Client-Einstellungen mit Verbindungstest, Fortschritt). Er verlangt Administratorrechte (UAC). Mit --silent und denselben Optionen läuft er ohne Fenster, etwa für die Softwareverteilung. Die Installation legt die Aufgabe „AegisGrid updater“ an, trägt <Installationsordner>\bin in den PATH ein, erzeugt einen Eintrag in „Apps & Features“ (Ändern und Deinstallieren) und im Startmenü den Ordner „AegisGrid“ mit „AegisGrid Setup“ und, solange die Komponente console bzw. tconsole installiert ist, „AegisGrid Verwaltungskonsole“ bzw. „AegisGrid Target-Konsole“. Die Vorauswahl „Client“ umfasst unter Windows Kern, Sicherungs-Agent, Wiederherstellung, Job-Planer und Verwaltungskonsole; „Benutzerdefiniert“ beginnt mit dieser Auswahl, dort lassen sich Planer und Konsole abwählen. Den Backup-Server gibt es nur unter Linux.

Sind Job-Planer und Verwaltungskonsole gewählt, fragt die Seite „Verwaltungskonsole“, welcher Windows-Benutzer die Konsole verwendet (vorbelegt: der angemeldete) und ob sie Jobs ändern, starten und abbrechen oder nur ansehen darf. Das Setup schaltet die API des Planers ein, erzeugt für diesen Benutzer das Token konsole-<Name> und hinterlegt die Verbindung; beim nächsten Start zeigt die Konsole „Dieser Computer“ bereits verbunden (Kapitel 14). Ohne Fenster: --console-user <Benutzer> und --console-role admin|read; --no-console-link lässt die Verbindung weg, --no-sched-api auch die API.

Hat der Planer dieses Computers danach noch keinen Job, bietet die letzte Seite das Häkchen „Erste Sicherung jetzt einrichten (öffnet die Verwaltungskonsole)“ an (vorbelegt). „Fertig“ startet die Konsole dann als angemeldeter Benutzer, nicht mit den Administratorrechten des Setups, und mit --first-run: Sie wählt „Dieser Computer“ und öffnet den Assistenten für die erste Sicherung (Abschnitt „Assistent für neue Jobs“). Unter Linux nennt der Bericht am Ende in diesem Fall die nächsten Schritte: einen Schlüssel mit openssl erzeugen, ein Ziel ([sink:usb]), ein Profil [computer] und einen Job mit schedule = 0 21 * * * und retention = 30d in bkp_sched.cfg eintragen, dann bkp_sched validate, list und run.

Ist der Job-Planer gewählt, folgt die Seite „Freigabe für andere Rechner“: Damit bekommen die Verwaltungskonsolen der anderen Rechner desselben Kontos diesen Planer von selbst (Kapitel 14, Abschnitt „Scheduler für andere Konsolen freigeben“). Ohne Fenster: --console-release read|admin|off; ohne den Schalter bleibt die Freigabe, wie sie ist. Den Schalter gibt es auch unter Linux.

2.2.3 Freischaltung während der Installation#

Liefert der Update-Server den Kanal nur an freigeschaltete Installationen (Kapitel „Automatische Updates“, Abschnitt „Freischaltung der Installation“), fragen der Text-Assistent (Linux) und der Windows-Assistent nach dem Laden des Katalogs nach dem Freischaltcode (CB-XXXXX-XXXXX-XXXXX-XXXXX, z. B. der Testcode der Demo-Version). Das Setup prüft die Schreibweise selbst, fragt beim AegisGrid-Lizenzserver an, lädt danach den Katalog erneut, jetzt mit dem Installationszertifikat, und installiert wie gewohnt. Groß- und Kleinschreibung und die Bindestriche sind egal; Verwechslungen wie O und 0 oder I, L und 1 gleicht es aus. Kennt die Version keinen Lizenzserver, bieten die Assistenten nur den Weg per Datei an.

Ohne Freischaltcode oder ohne Internetverbindung geht es per Datei: eine Anfrage für die Freischaltung speichern, sie an den AegisGrid-Support senden und dessen Antwort einspielen. Ist schon eine Anfrage offen, schlagen die Assistenten das Einspielen der Antwort vor; eine neue Anfrage ersetzt die offene erst nach Rückfrage. Ein fehlgeschlagener Versuch mit Freischaltcode lässt eine offene Anfrage unberührt.

Unter Windows erscheint dafür die Seite „Freischaltung“: oben das Feld „Freischaltcode“ mit dem Knopf „Freischalten“ (auch mit der Eingabetaste), darunter „Anfrage speichern...“ (Vorschlag: Dokumente\aegisgrid-anfrage-<rechner>.json, „Ordner öffnen“ zeigt die Datei im Explorer) und „Antwort einspielen...“. Ist der Lizenzserver nicht erreichbar, nennt die Seite den Grund und setzt den Fokus auf den Datei-Weg. Das Setup darf zwischen Anfrage und Antwort geschlossen werden; beim nächsten Start erkennt es die offene Anfrage. Ohne Fragen (Linux und Windows):

./bkp_setup --silent --accept-eula --preset client --activation-code-file /root/code.txt   # die Datei enthält den Freischaltcode

# per Datei:
./bkp_setup --activation-request /root/anfrage.json            # schreibt die Anfrage und endet
# Datei an den AegisGrid-Support senden, die Antwort kommt zurück
./bkp_setup --silent --accept-eula --preset client --activation-response /root/antwort.json

Der Freischaltcode steht in einer Datei statt auf der Befehlszeile, damit er nicht in der Prozessliste oder der Shell-Historie landet. --activation-code-file und --activation-response schalten vor dem Laden des Katalogs frei; danach schicken Setup und Updater das Installationszertifikat bei jedem Zugriff mit. Unter Windows schickt WinHTTP das Zertifikat mit; den Schlüssel legt es dafür nur für die Dauer der Verbindung im Windows-Schlüsselspeicher ab.

2.2.4 Ändern, reparieren, entfernen#

bkp_setup --modify --components core,agent,monitor   # Komponenten hinzufügen oder entfernen
bkp_setup --repair                                   # fehlende oder beschädigte Dateien neu laden
bkp_setup --uninstall                                # entfernt Programme, Timer/Aufgabe, Einträge, gibt den Lizenzplatz frei
bkp_setup --uninstall --purge                        # zusätzlich Einstellungen, Schlüssel und Zertifikate
                                                     # (Windows: ganz %ProgramData%\AegisGrid, auch Protokolle)
bkp_setup --list-components                          # Katalog anzeigen

2.3 Erster Test#

bkp_agent --help | head -3
bkp_updater --status

Ausgabe:

bkp_agent 2.0.0-alpha.001 (build <n>)

Usage: bkp_agent --source <path> (--out <dir> | --target <host:port> ... | --sink <name>)

bkp_updater 2.0.0-alpha.001
platform: linux x86_64 debian  glibc 2.41
update url: (none: updates are off)
channel: alpha
trusted keys: 0
last manifest sequence: 0
dependencies: auto, package install not allowed