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.
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
- Öffnen Sie als Administrator im Browser About (
/#/about). - 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-ca44911verö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.confgesondert. 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:
| Modus | Ihre Aufgabe |
|---|---|
| Manual only | Sie starten jede Prüfung und Installation selbst. Dies ist die Voreinstellung |
| Check automatically | Prüfungen laufen nach Zeitplan. Sie entscheiden über die Installation |
| Install automatically | Installationen laufen nach Zeitplan. Verwenden Sie dies erst nach ausdrücklicher Freigabe der Installation in Ihrem Wartungsfenster |
Für einen zeitgesteuerten Modus:
- Prüfen Sie Appliance timezone. Der Zeitplan verwendet diese Zeitzone, nicht die des Hosts oder Browsers. Vergleichen Sie sie mit der Ausgabe von
timedatectl. - 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.
- Wählen Sie Save automatic update settings.
- 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
- Verbinden Sie sich erneut mit der Weboberfläche und öffnen Sie About. Prüfen Sie die erwartete Anwendungsversion.
- Prüfen Sie, dass die erwarteten Hosts verbunden sind und ihr Inventar erscheint.
- 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 Wert | Bedeutung |
|---|---|
/run/xoa-hl/status | Letzte Prüfung: UP_TO_DATE, AVAILABLE oder ERROR. Geht beim Appliance-Neustart verloren |
/var/lib/xoa-hl/update.log | Ausgabe der verwalteten Installation mit abschließender Erfolgs- oder Fehlermarkierung. Wird beim nächsten Versuch überschrieben |
/var/lib/xoa-hl/auto-update.status | Nur automatische Läufe. Vergleichen Sie startedAt und finishedAt (UTC) mit der Updatezeit |
result=check_failed oder result=failed | Prüfung oder Installation fehlgeschlagen: Lesen Sie das Protokoll. Keiner der Werte bedeutet Erfolg |
rebootNeeded=yes, no oder unknown | Einschä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.
| Problem | Prüfen |
|---|---|
| Nur der Browser wurde getrennt | Die Anwendungsinstallation startet xo-server neu. Prüfen Sie Dienst und Protokoll über die Konsole, bevor Sie es erneut versuchen. |
| Der Updater scheint belegt | Prü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 verpasst | Die 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 unklar | Sichern Sie die Protokolle und nutzen Sie die Fehlerbehebung, bevor Sie ein weiteres Update planen. |
| Die Appliance wurde während eines Updates angehalten | Starten 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 erfordern | Starten 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ückkehren | Ein 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. |