Knoten aktualisieren und entfernen

Der Helfer restow-pve und das Storage-Plugin auf einem Knoten stammen von Ihrer Restow-Instanz und sind mit ihr versioniert. Ein Server-Update bringt ein neues Release von beiden, und die Knoten ziehen nach. Diese Seite behandelt das Aktualisieren, die Befehle des Helfers und das Entfernen eines Knotens.

Die Knoten nach einem Server-Update aktualisieren

Aktualisieren Sie zuerst den Restow-Server (siehe Updates). Die Instanz bietet den Knoten dann ihr eigenes Release an. Ein Knoten lässt sich auf diesen Wegen aktualisieren:

• Mit dem Server-Update (seit 0.4.2). Sobald der Server das neue Release ausführt, bleiben neue Läufe angehalten, während jeder Knoten, der sich meldet, aufgefordert wird, sofort zu aktualisieren (er ist dann frei), bis alle erreichbaren Knoten die neue Version haben oder 15 Minuten vergangen sind. Der Reiter Updates zeigt den Fortschritt und nennt den Befehl für die Knoten, die er nicht erreicht hat. Siehe Knoten und Agenten ziehen das Update nach.

• Für die ganze Flotte, auf Anforderung (seit 0.4.3). Läuft der Server mit einem neueren Release als seine Knoten, hat aber kein Update in den Schritt oben geführt (der Server wurde von Hand aktualisiert, oder die Antwort auf ein angekündigtes Update ging verloren), zeigen Knoten, die zurückliegen, im Reiter Updates Update verfügbar, und Knoten und Agenten jetzt aktualisieren startet dort den Schritt: Neue Läufe werden höchstens 15 Minuten angehalten, und jeder erreichbare Knoten installiert das Release, sobald er frei ist. Siehe Knoten und Agenten jetzt aktualisieren.

• Über die Weboberfläche (seit 0.4.2). Im Reiter Knoten bittet Auf X.Y.Z aktualisieren neben der Version des Knotens (sichtbar, solange ein neueres Release angeboten wird, auch außerhalb eines Server-Updates) den Knoten, das Release zu installieren, sobald auf ihm keine Sicherung und keine Wiederherstellung läuft. Der Knoten tut das bei seiner nächsten Meldung und startet neu; währenddessen steht „Wird auf X.Y.Z aktualisiert…“, und das Audit-Log hält pve.node.update_requested fest. Proxmox VE selbst aktualisiert Restow nie.

• Von selbst. Der laufende Helfer fragt die Instanz alle sechs Stunden nach einem neueren Release und installiert es, solange auf dem Knoten keine Sicherung und keine Wiederherstellung läuft, und startet dann sich selbst neu. Ein Helfer ab 0.4.1 fragt außerdem zwei Minuten nach seinem Start, damit ein neu gestarteter Knoten nicht stundenlang eine alte Version behält. Vor 0.4.1 kam die erste Frage erst sechs Stunden nach dem Start. Vorher werden die Release-Signatur und die SHA-256 jeder Datei geprüft. Die Plugin-Dateien werden auf der Platte ersetzt, und die Proxmox-VE-Daemons laden sie bei ihrem nächsten Neustart. Seit 0.4.3 übernimmt der Helfer diesen Neustart selbst: Nachdem er ein Update installiert hat, startet er pvedaemon, pveproxy, pvestatd und pvescheduler neu, wie es der Installer tut (systemctl reload-or-restart bei den laufenden; ein Fehler wird protokolliert und macht das Update nicht rückgängig). Ein Knoten, den ein Helfer vor 0.4.3 aktualisiert hat, startet sie einmal von selbst neu, nachdem das neue Release gestartet ist; den Hash der Plugin-Dateien, für die er sie neu gestartet hat, behält er in /var/lib/restow-pve/plugin-loaded.

• Sofort, mit einem Befehl. Als root auf dem Knoten:

  restow-pve update

  Gibt es nichts Neues, gibt er No newer release offered. aus. Sonst installiert er das Release. Seit 0.4.3 startet er die Proxmox-VE-Daemons und den laufenden Dienst restow-pve selbst neu, sodass der Knoten das neue Release mit seinem nächsten Heartbeat meldet, und endet mit „Updated to X.Y.Z.“ (englischer Text). Ein Helfer vor 0.4.3 installiert das Release und sagt Ihnen, die Dienste selbst neu zu starten: systemctl restart restow-pve pvedaemon pvestatd pveproxy pvescheduler. Die Proxmox-VE-Daemons laden das Storage-Plugin erst beim Start, eine neue Plugin-Version gilt also nach diesem Neustart. Das Update wird abgelehnt, solange eine Sicherung oder eine Wiederherstellung läuft („a backup or restore is running; the update waits“, englischer Text).

• Indem Sie den Installationsbefehl noch einmal ausführen. Auf einem angemeldeten Knoten aktualisiert oder repariert curl -fsSL 'https://<Ihre Instanz>/install/pve.sh' | sh ihn an Ort und Stelle, braucht kein Token und behält die Anmeldung. Er startet die Proxmox-VE-Daemons selbst neu.

Die Version des Helfers jedes Knotens steht in der Spalte restow-pve des Reiters Knoten unter Server & Clients → VMs & Container.

Wann: Die Release Notes sagen es, wenn ein Release die Knotenseite ändert.

• Seit 0.3.2 meldet das Plugin die Storage-API des laufenden Proxmox VE, sodass Proxmox VE 9 nicht mehr warnt, es „is implementing an older storage API“. Knoten, die mit 0.3.1 verbunden wurden, funktionieren weiter und brauchen restow-pve update, damit die Warnung verschwindet.

• 0.3.4 hat Sicherungen nicht privilegierter Container auf ext4 korrigiert (der Ordner lost+found) und behält den Sicherungsstand einer Container-Sicherung, die restic nicht vollständig lesen konnte. Führen Sie restow-pve update auf jedem Knoten aus, damit die Korrektur dort gilt. Die Serverseite funktioniert auch mit älteren Helfern.

• 0.4.0 bringt die Knotenseite mehrerer Funktionen: den Fortschritt einer laufenden Sicherung, die eigenen Zeilen des Helfers im Log des Laufs und die Namen der ersten 20 nicht lesbaren Elemente einer Container-Sicherung, ein Wiederholungsfenster von fünf Minuten, während Restow aktualisiert, die Liste der Läufe, an denen der Knoten arbeitet (Restow nutzt sie, um verlorene Läufe zu schließen), restic, das einen Container vor der Sicherung durchsucht, und Startprüfungen. Ältere Helfer funktionieren ohne diese weiter: Eine Sicherung zeigt „Noch kein Fortschritt gemeldet“ (seit 0.4.1 sagt die Seite, dass der Fortschritt restow-pve 0.4.0 auf diesem Knoten braucht und welche Version dort läuft), und ein Gast auf einem solchen Knoten lässt sich nicht per Startprüfung prüfen („restow-pve auf dem Knoten des Gasts führt keine Startprüfungen aus“).

• Ab 0.4.1 fragt der Helfer zwei Minuten nach seinem Start nach seinem Update (siehe oben). Das ist die einzige Änderung auf dem Knoten. Das Update wartet weiterhin, bis keine Sicherung und keine Wiederherstellung läuft.

• Ab 0.4.2 meldet der Helfer die VM, auf der Restow selbst läuft, mit dem Inventar (Die VM des Restow-Servers selbst), hält seinen Heartbeat aufrecht, solange eine Sicherung läuft (alle 15 Sekunden, was Sicherung stoppen und der Fortschritt brauchen), fordert von vzdump keine Notizen mehr an, sodass eine Sicherung nicht mehr wegen „TASK WARNINGS“ als fehlgeschlagen gemeldet wird (Erfolgreich mit Warnungen), und behält das Ergebnis einer Aufgabe, das der Server nicht annehmen konnte, bis zum nächsten Heartbeat, statt es zu verlieren. Ältere Helfer arbeiten weiter: Sicherung stoppen beendet eine laufende Sicherung erst bei ihrem nächsten Upload, die VM des Restow-Servers muss von Hand markiert werden, und ein Ergebnis, das spät eintrifft, nimmt der Server trotzdem an.

• Ab 0.4.3 wartet der Helfer bei einer Container-Sicherung auf die Repository-Sperre des Servers (bis zu 15 Minuten) und startet die Proxmox-VE-Daemons nach einem eigenen Update selbst neu, sodass ein neues Storage-Plugin ohne manuellen Neustart geladen wird. Knoten mit restow-pve 0.4.1 brauchen ein Update von Hand. Sie ignorieren „jetzt aktualisieren“ und den Schritt nach einem Server-Update; sie aktualisieren sich mit ihrer eigenen Prüfung (zwei Minuten nach dem Start des Dienstes, danach alle sechs Stunden) oder sofort von Hand, als root, sobald dort keine Sicherung und keine Wiederherstellung läuft:

  /opt/restow-pve/bin/restow-pve update
  systemctl restart restow-pve pvedaemon pvestatd pveproxy pvescheduler

  Knoten, die restow-pve ab 0.4.2 laufen lassen, übernehmen das neue Release mit dem Schritt nach dem Server-Update oder mit Knoten und Agenten jetzt aktualisieren.

Container brauchen restow-pve ab 0.4.6. Sein Plugin behebt die Wiederherstellung von Containern auf dem aktuellen Proxmox VE, wo vorher jede Container-Wiederherstellung und jede Startprüfung scheiterte. Wenn Sie sich auf eines davon verlassen, aktualisieren Sie vorher jeden Knoten, und führen Sie bei Sicherungsständen, die Nicht gestartet oder eine fehlgeschlagene Restore-Prüfung zeigen, einmal Jetzt Start prüfen oder Jetzt prüfen aus (Wiederherstellen).

Was Sie auf einem Knoten tun können

Alle Befehle laufen als root.

Befehl	Was er tut
restow-pve status	Der lokale Zustand und die letzte Meldung an Restow, auch ob Startprüfungen an sind und mit welchem Speicher. --json für Skripte.
restow-pve diagnose	Jede Prüfung, die eine Sicherung braucht, mit den Befunden. --json für Skripte.
restow-pve test	Wie diagnose, und der Exit-Code ist nur dann 0, wenn alles in Ordnung ist.
restow-pve config --allow-restores=false	Die Wiederherstellungen ablehnen, die Restow bei diesem Knoten anfordert. Das ist die eigene Entscheidung des Knotens, der Server kann sie nicht ändern. --allow-restores=true erlaubt sie wieder.
restow-pve config --pve-cert-sha256 <sha>	Das Zertifikat der lokalen Proxmox-VE-API festlegen, wenn es nicht von der Zertifizierungsstelle des Clusters signiert ist (ein eigenes pveproxy-Zertifikat).
restow-pve config --fleecing-storage <Speicher>	Den Thin-Speicher ändern, den dieser Knoten für Fleecing-Abbilder nutzt.
restow-pve config --restore-tmp <Ordner>	Der Ordner, in den eine Container-Wiederherstellung entpackt wird, bevor Proxmox VE sie in das neue Root-Dateisystem kopiert. Standard: /var/tmp/restow-pve.
restow-pve config --boot-tests=false	Auf diesem Knoten keine Startprüfungen ausführen und sie nicht mehr anmelden. --boot-tests=true erlaubt sie wieder. Seit 0.4.0, siehe Startprüfungen.
restow-pve config --boot-test-storage <Speicher>	Der Speicher für die temporären Gäste der Startprüfungen. Vorgabe: der Fleecing-Speicher.
restow-pve config --boot-test-bridge <Bridge>	Die Netzwerkkarten von Startprüfungen mit dieser isolierten Bridge verbinden, statt sie mit link_down=1 zu kappen. - löscht sie.
restow-pve update	Ein neueres Release installieren, das die Instanz anbietet. Der Reiter Updates nennt ihn für Knoten, die ein Server-Update nicht erreicht hat (seit 0.4.2).
restow-pve uninstall --yes	Den Helfer, das Plugin und die Zugangsdaten entfernen. Die Sicherungen bleiben in Restow.

Jeder config-Befehl speichert die Einstellung und bittet Sie, den Dienst neu zu starten: systemctl restart restow-pve.

Wo was liegt: der Zustand in /etc/restow-pve/state.json (das Secret des Knotens und der API-Token, nur root), Caches und das Journal in /var/lib/restow-pve (darin boottest/, solange eine Startprüfung läuft; seit 0.4.2 auch pending-results.json, die Ergebnisse von Aufgaben, die der Server noch nicht annehmen konnte, höchstens 100; seit 0.4.3 auch plugin-loaded, der Hash der Plugin-Dateien, für die die PVE-Daemons zuletzt neu gestartet wurden), der Zustand laufender Jobs in /run/restow-pve und das Log unter journalctl -u restow-pve.

Einen Knoten in Restow widerrufen

Wählen Sie im Reiter Knoten im Zeilenmenü des Knotens Widerrufen und bestätigen Sie. Der Knoten kann danach nichts mehr sichern oder wiederherstellen, und seine vorhandenen Sicherungsstände bleiben erhalten. Nutzen Sie es, wenn ein Knoten außer Dienst gestellt wird oder verloren ist. Die Zugangsdaten eines widerrufenen Knotens werden abgewiesen. Um den Knoten wieder zu nutzen, entfernen Sie auf ihm den Helfer (unten) und verbinden Sie ihn mit einem neuen Befehl, der die frühere Anmeldung ersetzt.

Helfer und Plugin entfernen

Auf dem Knoten, als root:

restow-pve uninstall --yes

Ist der Helfer defekt oder schon weg, räumt das Installationsskript auf, was übrig ist:

curl -fsSL 'https://<Ihre Instanz>/install/pve.sh' | sh -s -- --uninstall

Das entfernt die Unit restow-pve.service, das Storage-Plugin, den Zustand, die Caches und die Binärdateien. Das Installationsskript startet außerdem die Proxmox-VE-Daemons neu, damit sie das Plugin entladen. Nach restow-pve uninstall --yes allein führen Sie systemctl daemon-reload; systemctl restart pvedaemon pvestatd pveproxy pvescheduler aus, wie der Befehl es ausgibt. Die Sicherungen bleiben in Restow. Danach:

1. Entfernen Sie den Speicher in Proxmox VE, wenn ihn kein Knoten mehr nutzt: pvesm remove <Speicher-ID> (standardmäßig restow). Das tut der zuletzt entfernte Knoten.
2. Widerrufen Sie den Knoten in Restow, siehe oben.
3. Entfernen Sie, was das Installationsskript in Proxmox VE eingerichtet hat, wenn Sie es nicht mehr brauchen. Die Deinstallation rührt den Benutzer restow@pve, seine Rollen, den Pool restow-restore und den API-Token des Knotens nicht an. Löschen Sie zumindest den Token des Knotens, damit sein Secret nicht mehr gültig ist: pveum user token remove restow@pve <Knotenname>. Gäste, die in den Pool wiederhergestellt wurden, bleiben, wo sie sind.

Um den Knoten später wieder zu verbinden, erstellen Sie in Restow einen neuen Befehl, siehe Knoten verbinden.