Zum Inhalt springen

Appliance warten und aktualisieren

Aktualisieren Sie die XOA-HL-Appliance in vier Schritten: Erfassen Sie die installierten Komponenten, bereiten Sie ein Wartungsfenster vor, wählen Sie die Ausführung der Updates und prüfen Sie anschließend das Ergebnis. Sie arbeiten im Browser, als Administrator bei XOA-HL angemeldet. Einige lesende Prüfungen führen Sie innerhalb der Appliance über deren Konsole oder SSH aus.

Gilt für Image xoa-image-20261022-a280852, Pakete v5.113.2_e281c536-ce43 bis v5.113.2_e281c536-ce47 (Xen Orchestra 5.113.2). Am 27.10.2026 auf einer Labor-Appliance getestet. Spätere Pakete können sich anders verhalten. Zum am 27.10.2026 mit der Bereitstellungskorrektur (build-xoa-hl@fa0c987) neu erstellten Image siehe Erste Anmeldung. Der oben genannte Testumfang bleibt unverändert.

1. Ausgangszustand erfassen

  1. Öffnen Sie als Administrator im Browser About (/#/about).
  2. Notieren Sie XOA-HL version, XOA-HL VM version, die Adresse der Appliance und den ursprünglichen Image-Tag. Die VM-Version ist eine Image-Bezeichnung. Sie unterscheidet nicht zwischen den beiden unter xoa-image-20261027-ca44911 veröffentlichten Dateien. Notieren Sie auch den ursprünglichen Dateinamen und die SHA-256-Prüfsumme; siehe die Image-Prüfung. Ein Anwendungsupdate ändert die VM-Version nicht.

Wenn Sie autorisierten Konsolen- oder SSH-Zugriff haben, führen Sie diese lesenden Befehle innerhalb der Appliance aus. Verwenden Sie bei Bedarf Root-Rechte.

rpm -q xoa-hl nodejs
cat /etc/xoa-hl-vm-release
timedatectl
systemctl list-timers 'xoa-hl-*'

Bewahren Sie die Ausgabe zusammen mit der Versionsmatrix und den Versionshinweisen auf. Die Matrix nennt die zusammen ausgelieferten Komponenten; sie belegt keine gemeinsamen Tests.

2. Updatefenster vorbereiten

  • Exportieren Sie die XO-Konfiguration. Bewahren Sie die Datei und ihre Passphrase außerhalb der Appliance auf.
  • Dokumentieren Sie Änderungen an /root/.config/xo-server/config.toml, den TLS-Dateien und /etc/xoa-hl/update.conf gesondert. Der Webexport enthält diese Dateien nicht.
  • Prüfen Sie, dass Sie die Appliance-Konsole über XO Lite öffnen können, falls die Weboberfläche ausfällt.
  • Prüfen Sie, dass Sicherungen, Wiederherstellungen und andere Verwaltungsaufgaben abgeschlossen sind.
  • Planen Sie genug Zeit für einen Dienstneustart und gegebenenfalls einen späteren Neustart der Appliance ein.

Diese Seite aktualisiert ausschließlich die XOA-HL-VM. Hostupdates sind eine eigene Aufgabe: Im Updateleitfaden finden Sie die richtigen Zielsysteme und Befehle.

3. Modus und Kanal wählen

Öffnen Sie Settings → XOA-HL Updates (/#/settings/xoa-hl-updates). Für manuelle Updates folgen Sie der Updateanleitung für Check for update und Update now.

Wählen Sie einen Mode:

ModusIhre Aufgabe
Manual onlySie starten jede Prüfung und Installation selbst. Dies ist die Voreinstellung
Check automaticallyPrüfungen laufen nach Zeitplan. Sie entscheiden über die Installation
Install automaticallyInstallationen laufen nach Zeitplan. Verwenden Sie dies erst nach ausdrücklicher Freigabe der Installation in Ihrem Wartungsfenster

Für einen zeitgesteuerten Modus:

  1. Prüfen Sie Appliance timezone. Der Zeitplan verwendet diese Zeitzone, nicht die des Hosts oder Browsers. Vergleichen Sie sie mit der Ausgabe von timedatectl.
  2. Legen Sie Frequency, bei wöchentlicher Ausführung den Day, und Local start time fest. Der Lauf beginnt zu dieser Zeit ohne zufällige Verzögerung.
  3. Wählen Sie Save automatic update settings.
  4. Prüfen Sie die gespeicherten Einstellungen und die Timerliste von systemctl list-timers 'xoa-hl-*'.

Belassen Sie Update channel für die reguläre Wartung auf Stable. Testing ergänzt Kandidatenpakete: Verwenden Sie diesen Kanal nur auf einer entbehrlichen Test-Appliance. Ein Kanalwechsel installiert nichts und stuft ein bereits installiertes Kandidatenpaket nicht zurück.

Das verwaltete Update führt ein vollständiges dnf-Update mit Ausnahme von nodejs aus. Die Installation des Anwendungspakets startet xo-server nach der Transaktion neu; dadurch kann die Webseite die Verbindung verlieren. Das allein bedeutet keinen Updatefehler.

4. Ergebnis prüfen

  1. Verbinden Sie sich erneut mit der Weboberfläche und öffnen Sie About. Prüfen Sie die erwartete Anwendungsversion.
  2. Prüfen Sie, dass die erwarteten Hosts verbunden sind und ihr Inventar erscheint.
  3. Lesen Sie das Updateergebnis. Beim Öffnen zeigt die Seite die zuletzt gespeicherte Prüfung, auch eine zeitgesteuerte. Unter Last automatic result erscheint ein fehlgeschlagener automatischer Lauf in einem roten Hinweis.

Ist das Ergebnis unklar, führen Sie innerhalb der Appliance diese lesenden Prüfungen aus:

systemctl status xo-server xoa-hl-update.service --no-pager
journalctl -u xoa-hl-update.service -u xo-server --since '1 hour ago' --no-pager
tail -n 100 /var/lib/xoa-hl/update.log
cat /var/lib/xoa-hl/auto-update.status
cat /run/xoa-hl/status
Datei oder WertBedeutung
/run/xoa-hl/statusLetzte Prüfung: UP_TO_DATE, AVAILABLE oder ERROR. Geht beim Appliance-Neustart verloren
/var/lib/xoa-hl/update.logAusgabe der verwalteten Installation mit abschließender Erfolgs- oder Fehlermarkierung. Wird beim nächsten Versuch überschrieben
/var/lib/xoa-hl/auto-update.statusNur automatische Läufe. Vergleichen Sie startedAt und finishedAt (UTC) mit der Updatezeit
result=check_failed oder result=failedPrüfung oder Installation fehlgeschlagen: Lesen Sie das Protokoll. Keiner der Werte bedeutet Erfolg
rebootNeeded=yes, no oder unknownEinschätzung des automatischen Laufs. unknown bedeutet nicht, dass kein Neustart erforderlich ist. Auf diesem Image ist der Wert immer unknown: Als root zeigt dnf needs-restarting -r, ob ein Neustart nötig ist

Eine manuelle Installation aktualisiert den Datensatz automatischer Läufe nicht. Ein Prüfdienst kann erfolgreich enden und dennoch ein Problem melden; lesen Sie sein Ergebnis. Sichern Sie die relevanten Protokolle vor einem weiteren Versuch.

Prüfung: About zeigt die erwartete Version, die erwarteten Hosts sind verbunden und das Updateergebnis meldet Erfolg.

Wenn das Update nicht sauber endet

Es gibt keinen automatischen Neustart. Verwaltete Prüfung und Installation teilen sich eine Sperre; ein in einer Shell gestarteter dnf-Befehl fällt jedoch nicht darunter. Solange ein Update laufen könnte, starten Sie niemals einen weiteren dnf-Prozess, stoppen Sie keine laufende Transaktion und starten Sie nicht neu, um den belegten Updater freizugeben.

ProblemPrüfen
Nur der Browser wurde getrenntDie Anwendungsinstallation startet xo-server neu. Prüfen Sie Dienst und Protokoll über die Konsole, bevor Sie es erneut versuchen.
Der Updater scheint belegtPrüfen Sie Dienst und Protokoll über die Konsole. Starten Sie keinen weiteren dnf, stoppen Sie keine Transaktion und starten Sie nicht neu, um ihn freizugeben.
Ein automatisches Installationsfenster wurde verpasstDie verpasste Installation wird beim nächsten Appliance-Start nicht sofort nachgeholt. Planen Sie ein neues Fenster.
Der Appliance-Start wurde unterbrochen oder das Ergebnis ist unklarSichern Sie die Protokolle und nutzen Sie die Fehlerbehebung, bevor Sie ein weiteres Update planen.
Die Appliance wurde während eines Updates angehaltenStarten Sie sie neu und prüfen Sie vor allem anderen die Pakete. Ein neues Update kann Erfolg melden und trotzdem beschädigte Pakete zurücklassen: Folgen Sie Pakete nach einem unterbrochenen Update reparieren.
Die installierten Änderungen könnten einen Neustart erfordernStarten Sie erst neu, wenn keine Transaktion oder Verwaltungsaufgabe mehr läuft und Sie entschieden haben, dass die Änderungen dies erfordern. Prüfen Sie danach Anmeldung, Versionen und Inventar erneut.
Sie möchten zur vorherigen Version zurückkehrenEin Paket-Downgrade ist kein getestetes Wiederherstellungsverfahren. Es stellt weder das Basisbetriebssystem noch XO-Daten oder eigene Dateien wieder her. Lesen Sie zuerst die Grenzen der Wiederherstellung.
Quellen