# Einen HA-Knoten sicher warten
Typ: Checkliste
Herkunft: virtualization-private-cloud / cluster-ha / virt-maintenance-sequence
Version: virt-maintenance-sequence-2026-09-12
Geprüft: 2026-09-12

ACHTUNG: Dieses Dokument ist ein Lernartefakt aus einer Schulungssequenz. Es ist kein produktives Runbook. Vor jeder Anwendung in einer realen Umgebung müssen die Schritte gegen lokale Dokumentation, Runbooks und Freigabestatus geprüft werden.

## Szenario
Ein Knoten eines Proxmox-HA-Clusters braucht neue Firmware. Der Knoten trägt mehrere HA-Dienste, darunter eine VM mit strikter Knotenbindung durch ein durchgereichtes Gerät.

## Schritte
1. Restkapazität und zulässige Ziele prüfen — auch für die VM, die wegen des durchgereichten Geräts nicht migrieren kann.
2. `ha-manager crm-command node-maintenance enable NODENAME` absetzen, um den Knoten für HA als nicht verfügbar zu markieren.
3. Warten, bis kein HA-Dienst mehr auf dem Knoten liegt; als Signal dient die Protokollzeile `watchdog closed (disabled)`, nicht die Statusanzeige.
4. Firmware einspielen und den Knoten neu starten.
5. Wartungsmodus ausdrücklich mit `node-maintenance disable` aufheben, weil ein Neustart ihn nicht entfernt.
6. Rückkehr der Dienste und Clusterzustand prüfen, bevor der nächste Knoten an die Reihe kommt.

## Begründung
Warum: Ein angekündigter Eingriff unterscheidet sich von einem Ausfall dadurch, dass die Reihenfolge frei wählbar ist. Diese Freiheit verfällt, sobald ein Schritt beginnt, bevor der vorige nachweislich abgeschlossen ist — dann trifft die Wartung dieselben Schutzmechanismen wie eine Störung.
Folgen: **+** Die Dienste wandern kontrolliert ab und kehren nach der Wartung automatisch zurück. **−** Der Ablauf kostet Zeit, der Watchdog bleibt während des Verschiebens aktiv, und eine lokal gebundene VM zwingt zu einer eigenen Entscheidung, bevor überhaupt begonnen werden darf.

## Quellen
1. https://pve.proxmox.com/pve-docs/chapter-ha-manager.html