Zum Inhalt springen
Dokumentation XOA-HL-HandbuchKonfigurationsexport

XO-Konfiguration exportieren

Speichern Sie vor der Appliance-Wartung die XO-Konfiguration in einer Datei und bewahren Sie sie getrennt von Ihren VM-Sicherungen auf. Testen Sie die Datei anschließend auf einer entbehrlichen Appliance. Pool-Metadaten benötigen einen eigenen Sicherungsjob, wie unten beschrieben. Sie arbeiten im Browser, angemeldet bei XOA-HL als XO-Administrator.

Gilt für Image xoa-image-20261027-ca44911, Paket v5.113.2_e281c536-ce47 (Xen Orchestra 5.113.2). Am 27.10.2026 auf Labor-Appliances getestet: Export, Import und Wiederherstellung auf einer neuen Appliance derselben Version. Diese Seite beschreibt keinen unterstützten Wiederherstellungs- oder Downgrade-Weg. Am 27.10.2026 mit der Bereitstellungskorrektur in build-xoa-hl@fa0c987 neu erstellt. Siehe So erkennen Sie die korrigierte Datei. Die in #315 dokumentierten Ergebnisse zu Export/Import und VM-Erstellung stammen aus der Zeit vor diesem Neubau. Eine Wiederholung dieser Tests mit der neu erstellten Datei ist hier nicht dokumentiert.

Inhalt des Exports

Der Export speichert die XO-Konfiguration: Benutzer und Gruppen, Zugriffsregeln, Serververbindungen, Remotes, Jobs, Zeitpläne, Authentifizierungstoken und Plugin-Einstellungen. Behandeln Sie die Datei als Geheimnis: Sie kann Serverpasswörter, Remote-Zugangsdaten und Token enthalten.

InhaltSchutz
XO-KonfigurationDieser Export unter Settings → Config
Gastfestplatten und -datenSeparate VM-Sicherung und -Wiederherstellung
Host- und Pool-MetadatenSeparate Pool-Metadatensicherung. Nicht in diesem Export enthalten
Appliance-Betriebssystem, RPM-Pakete und LaufzeitprotokolleNicht im Export enthalten
Server-TOML-Datei, TLS-Dateien, Update-Einstellungen und ZeitzoneNicht im Export enthalten. Separat erfassen

Ein abgeschlossener Export beweist nicht, dass die Datei Ihre Installation wiederherstellen kann. Bewahren Sie die Image- und Anwendungsversionen zusammen mit ihr auf.

1. Export herunterladen und aufbewahren

  1. Melden Sie sich im Browser als XO-Administrator an. Notieren Sie die installierten Versionen.
  2. Öffnen Sie Settings → Config (/#/settings/config). Wählen Sie unter Export die Option Download current config.
  3. Geben Sie eine einzigartige Passphrase ein und bestätigen Sie. Bleibt sie leer, ist der Export unverschlüsselt.
  4. Bewahren Sie die Passphrase getrennt auf, damit sie beim Verlust der Appliance noch verfügbar ist.
  5. Blockiert der Browser das neue Fenster, erlauben Sie den Download. Prüfen Sie, dass eine nicht leere Datei gespeichert wurde: config.json.gz, bei Verschlüsselung mit zusätzlichem .enc. Benennen Sie sie nicht so um, dass sie wie eine VM-Sicherung aussieht.
  6. Verschieben Sie die Datei auf geschützten Speicher außerhalb der Appliance. Notieren Sie Datum, Dateigröße, Versionen und Verschlüsselungsstatus.
  7. Behalten Sie den vorherigen Export, bis der neue einen Importtest auf einer isolierten Appliance besteht.

Prüfung: Datei und Passphrase sind ohne ursprüngliche Appliance erreichbar. Hängen Sie die Datei niemals an ein öffentliches Issue und fügen Sie ihren entschlüsselten Inhalt niemals in einen Bericht ein.

2. Import auf einer isolierten Appliance testen

Ein Import kann gespeicherte Server wieder verbinden und gespeicherte Zeitpläne aktivieren. Er kann vorhandene Einträge verändern und kollidierende Benutzer ersetzen. Für den gesamten Import gibt es keine Rücknahme: Nach einem Fehler können Teiländerungen verbleiben. Ermitteln Sie niemals an einer produktiven Appliance die Wirkung eines ungeprüften Exports.

Vor dem Beginn

  • Eine entbehrliche Appliance mit denselben notierten Image- und Paketversionen verwenden.
  • Ihr Netzwerk vor dem Import einschränken: Der Testbrowser erreicht sie, sie erreicht aber weder produktive Hosts noch Sicherungs-Remotes oder externe Dienste.
  • Einschränkung außerhalb von XO erzwingen. Vorheriges Deaktivieren von Verbindungen oder Zeitplänen reicht nicht, da der Import sie wiederherstellen kann.
  • Zustand der frischen Appliance notieren. Zugangsdaten aus der exportierten Konfiguration bereithalten: Der Import kann Konten verändern.
  1. Öffnen Sie Settings → Config. Wählen Sie die Exportdatei oder ziehen Sie sie hinein, wählen Sie Import und geben Sie die Export-Passphrase ein. Warten Sie auf Erfolgs- oder Fehlermeldung.
  2. Ist der Import erfolgreich, melden Sie sich ab und mit einem Administratorkonto aus dem Export erneut an.
  3. Vergleichen Sie Benutzer, Berechtigungen, Remotes, Server, Jobs und Zeitpläne mit Ihren Aufzeichnungen der Quelle. Bei blockiertem Netzwerk sind Serververbindungsfehler zu erwarten. Der Import entfernt keine Konten, die nicht in der Datei stehen: Löschen Sie jedes unerwartete Konto, zum Beispiel admin@admin.net.
  4. Deaktivieren Sie importierte Zeitpläne und entfernen oder ersetzen Sie produktive Ziele, bevor Sie Zugriff auf entbehrliche Testressourcen erlauben. Prüfen Sie diese Einstellungen vor jedem Test erneut.
  5. Bei fehlgeschlagenem Import Fehler und xo-server-Protokolle ohne Geheimnisse festhalten. Verwerfen Sie die Appliance und beginnen Sie den nächsten Versuch mit einer frischen. Nehmen Sie nicht an, dass ein fehlgeschlagener Import nichts verändert hat.

Prüfen Sie zuerst, dass sich der wiederhergestellte Administrator anmelden kann. Entfernen Sie unter Settings → Users unerwartete Konten, oder vergeben Sie bewusst behaltenen Konten neue, eindeutige Passwörter. Entfernen Sie niemals Ihren einzigen funktionierenden Administrator. Prüfen Sie in einer privaten Browsersitzung, dass admin@admin.net mit dem Passwort admin abgelehnt wird, und sichern Sie den korrigierten Zustand mit einem sauberen Neustart der Appliance, bevor Sie produktive Ressourcen wieder verbinden. Der Neubau vom 27.10.2026 behebt die Bereitstellung. An diesem Importverhalten ändert er nichts: Benutzer, die im Export fehlen, können auf dem Ziel bestehen bleiben.

Prüfung: Der exportierte Administrator kann sich anmelden; Benutzer, Berechtigungen, Remotes, Jobs und Zeitpläne entsprechen den Aufzeichnungen. Eine Erfolgsmeldung allein beweist keine Wiederherstellbarkeit. Falsche Passphrasen, kollidierende Benutzer und unterbrochene Importe werden hier nicht behandelt.

Schutz der Pool-Metadaten einrichten

Ein separater Job Pool metadata sichert die Metadaten eines Pools. XO liest vom gewählten Pool einen XAPI-Stream /pool/xmldbdump. Es schreibt data und metadata.json auf ein Remote unter xo-pool-metadata-backups/<schedule>/<pool>/<timestamp>/. Dies ist weder der Export unter Settings → Config noch eine VM-Festplattensicherung, ein Appliance-Image oder ein getesteter Weg zur Host-Wiederherstellung. Die Metadaten können Infrastrukturdetails verraten: Beschränken Sie den Remote-Zugriff und hängen Sie diese Dateien niemals an ein öffentliches Issue.

Vor dem Beginn

  • Einen eigenen, entbehrlichen und neu erstellbaren Pool verwenden, der mit XOA-HL verbunden ist. Für diesen Test niemals einen produktiven Pool ändern oder wiederherstellen.
  • Ein dediziertes, beschreibbares NFS-Sicherungs-Remote verwenden, das nicht vom Speicher dieses Pools abhängt, damit ein einzelner Ausfall nicht beide betrifft.
  • Separaten Plan zur VM-Sicherung und -Wiederherstellung für Gastdaten behalten.
  • Installiertes Image und Paket prüfen. Prüfen, dass der Administrator die Metadatensicherungs-Bedienelemente sieht: In dieser Version kann die Oberfläche sie hinter einer Planprüfung verbergen. Fehlen sie, anhalten.
  • Pool-UUID, Master- und Host-Identitäten, Remote-ID und freien Platz notieren.

Deaktivierten Job erstellen

  1. Öffnen Sie Backup → New und wählen Sie XO config & Pool metadata Backup (/#/backup/new/metadata). Nennen Sie den Job lab-pool-metadata.
  2. Aktivieren Sie nur Pool metadata, lassen Sie XO config aus.
  3. Wählen Sie den entbehrlichen Pool ausdrücklich aus. Wählen Sie nur das dedizierte Remote. Fügen Sie keine weiteren Pools oder Remotes hinzu.
  4. Fügen Sie einen Zeitplan mit ausdrücklicher Zeitzone hinzu. Setzen Sie Pool retention auf 2 und lassen Sie den Zeitplan deaktiviert.
  5. Speichern Sie. Lesen Sie Job- und Zeitplan-IDs, Pool, Remote, Modus, Aufbewahrung und deaktivierten Zustand zurück. Behält der Editor sie nicht bei, halten Sie an.

Job dreimal ausführen

  1. Starten Sie den Job manuell über seinen gespeicherten Zeitplan. Notieren Sie die Zeit: Dies ist Lauf A.
  2. Warten Sie auf den Abschluss. Prüfen Sie im Jobprotokoll jeden Pool und jedes Remote einschließlich Unteraufgaben. Ein Gesamterfolg beweist keine vollständige Remote-Kopie.
  3. Notieren Sie Lauf-ID, Status und UUID des Quellpools.
  4. Wiederholen Sie dies für Läufe B und C zu unterschiedlichen Zeiten. Starten Sie jeden Lauf erst nach Abschluss des vorherigen.

Aufbewahrte Punkte prüfen

  1. Öffnen Sie Backup → Restore → Metadata (/#/backup/restore/metadata). Betrachten Sie die Pool-Einträge aktivierter Remotes, ihre Zeiten und verfügbaren Punkte. Wählen Sie weder Restore noch Delete.
  2. Bei Aufbewahrung 2 bleiben nur die Punkte der Läufe B und C erhalten. Vergleichen Sie sie mit Ihren Aufzeichnungen zu A, B und C.
  3. Kann der Speicheradministrator das Remote direkt öffnen, lassen Sie jeden aufbewahrten Punkt prüfen: data und metadata.json sind nicht leer, und Job-, Zeitplan- sowie Pool-Identitäten stimmen. Dateigrößen und Hashes geschützt aufbewahren. Inhalte nicht veröffentlichen.
  4. Unvollständige Punkte oder unerwartete Bereinigungsergebnisse zur Untersuchung aufbewahren.

Der Job schreibt diese Dateien ohne Prüfsumme. Ein aufgelisteter Punkt oder eine erfolgreiche Aufgabe beweist nicht, dass XAPI ihn importieren kann.

Prüfung: Der Zeitplan ist weiterhin deaktiviert, die drei Läufe nennen vorgesehenen Pool und Remote, und aufbewahrte B-/C-Punkte samt Dateien entsprechen Ihren Aufzeichnungen. Schlagen Export, Remote-Schreibzugriff, Bereinigung oder Auflistung fehl, führen Sie den Job nicht weiter aus und bewahren Sie Protokolle und Inventar auf. Löschen Sie Sicherungsordner niemals nur aufgrund ihres Namens.

Vor jeder Pool-Wiederherstellung

Eine Pool-Wiederherstellung sendet data des gewählten Punkts an /pool/xmldbdump auf dem Zielpool. Sie verändert den Pool; eine Möglichkeit zur Rücknahme wurde nicht nachgewiesen. Vor jeder Wiederherstellung muss der Pool-Verantwortliche bereitstellen:

  • einen isolierten, entbehrlichen Zielpool
  • einen zu Versionen und Identitäten passenden Wiederherstellungsplan
  • eine separate Rückfallkopie von Image oder Metadaten
  • gesperrten Zugriff auf produktive Netzwerke und Speicher
  • ein Verfahren zur anschließenden Prüfung von Host-/Pool-Verbindung und Inventar

Wählen Sie erst nach Prüfung dieser Voraussetzungen genau einen Punkt und einen Zielpool. Ein verfügbarer Punkt oder erfolgreicher Export beweist keine Wiederherstellbarkeit. XO-Konfigurationsexporte und Gastsicherungen getrennt halten. Die Wiederherstellung selbst, Massenwiederherstellung und Wiederherstellung auf einem anderen Pool werden hier nicht behandelt.

Grenzen von Wiederherstellung und Rücknahme

Bei einem echten Verlust bewahren Sie die ausgefallene Appliance und die Nachweise auf. Ermitteln Sie exakte Versionen und verwenden Sie einen Wiederherstellungsplan, der für diese Versionen einen isolierten Test bestanden hat. Verbinden Sie niemals zwei Kopien mit aktiven Zeitplänen mit denselben produktiven Zielen.

Ein älteres RPM-Paket ist keine vollständige Rücknahme. Ein Downgrade macht weder Betriebssystemupdates rückgängig noch stellt es XO-Daten oder die oben separat genannten Dateien wieder her. Importe zwischen v5.113.2_e281c536-ce43 und v5.113.2_e281c536-ce47, die dieselbe Xen-Orchestra-Version verwenden, funktionierten im Labor in beide Richtungen. Importe zwischen Xen-Orchestra-Versionen und Wiederherstellung per Downgrade wurden nicht getestet. Scheitert ein Update, siehe Wartung und Fehlersuche.

Grenze der unterstützten Wiederherstellung (OP04/OP05)

Geltungsbereich: XO 5.113.2 e281c536, Quellen von XOA-HL ce40/ce47. Eine vollständige Rücknahme bzw. ein Downgrade der Appliance oder ein Notfall-Wiederherstellungsverfahren mit einem frischen Image wird von diesem Handbuch für diese Versionen nicht unterstützt. Das ist eine dokumentierte Grenze für Support und Abnahme, keine Behauptung, dass die Installation eines älteren RPM oder der Import einer Konfiguration technisch unmöglich wäre.

Der Konfigurationsexport serialisiert registrierte XO-Einstellungen, nicht das Betriebssystem der Appliance, die RPM-Transaktion, Gastdatenträger, TLS-Schlüssel oder Dateien des Betreibers. Der Updater von XOA-HL führt ein vorwärts gerichtetes dnf update aus; er bietet keine koordinierte Rücknahme von Daten und Betriebssystem. Die oben beschriebenen Beobachtungen zum Import von Einstellungen zwischen ce43 und ce47 validieren keine Wiederherstellung der gesamten Appliance.

Bevor ein Wiederherstellungsrezept angeboten werden kann, bewahren Sie ein bekanntes Image und die exakte RPM-Identität auf, einen verschlüsselten Konfigurationsexport mit Passphrase, die gesondert geschützte Betreiberkonfiguration mit TLS und anderen lokalen Dateien sowie unabhängige VM-Sicherungen. Bewahren Sie die ausgefallene Appliance offline auf. Ein Ersatz muss isoliert von jedem verwalteten Host, jedem Sicherungsziel und dem Produktionsnetz starten, bevor Einstellungen importiert werden, denn der Import kann Verbindungen und Zeitpläne aktivieren. Danach braucht er einen überprüften lokalen Zugang, wiederhergestellte Einstellungen und Dateien, deaktivierte Zeitpläne, eine bewusste Wiederverbindung von Hosts und Remotes, eine isolierte Gastwiederherstellung und Prüfungen auf doppelte Jobs. Importfehler können einen Teilzustand hinterlassen; bauen Sie das entbehrliche Ziel neu auf, statt blind erneut zu versuchen.

Dies sind Voraussetzungen für einen künftigen Test, keine überprüfte Wiederherstellungsabfolge mit frischem Image. Bis genau diese versionsspezifische Übung bestanden ist, holen Sie einen von den Maintainern genehmigten Wiederherstellungsplan ein. Führen Sie als Abkürzung zur Wiederherstellung kein dnf downgrade aus, überschreiben Sie Redis nicht, und verbinden Sie keinen ungeprüften Ersatz neben dem alten Scheduler.

Festgelegte Implementierung: packages/xo-server/src/xo-mixins/config-management.mjs, packages/xo-server/src/xo-mixins/scheduling.mjs, packages/xo-server/src/xo-mixins/xen-servers.mjs.

Vorwärts gerichteter Updater von XOA-HL, RPM-Lebenszyklus.

Quellen