"title":"Wiederherstellen eines Backups – vollständige und benutzerdefinierte Abläufe | ProxMenux",
"description":"Der komplette Wiederherstellungsworkflow. Dokumentiert die drei Aktionen, die für jedes Backup verfügbar sind (Ansicht, Download, Wiederherstellung), die Kompatibilitätsprüfung und ihre Ergebnisse, die vollständigen und benutzerdefinierten Wiederherstellungsmodi, die Pfadklassifizierung, die entscheidet, was live gilt und was auf den nächsten Start wartet, den On-Boot-Dispatcher und den Post-Boot-Komponentenneuinstallationspass.",
"ogTitle":"ProxMenux Backup — Wiederherstellung",
"ogDescription":"Vollständige und benutzerdefinierte Wiederherstellungsflüsse mit Kompatibilitätsprüfung, Pfadklassifizierung, On-Boot-Dispatcher und Post-Boot-Neuinstallation.",
"twitterTitle":"Wiederherstellen eines Backups | ProxMenux",
"twitterDescription":"Wie ein ProxMenux-Host-Backup wieder in einen funktionierenden Proxmox-Host umgewandelt wird."
},
"header":{
"title":"Wiederherstellen eines Backups",
"description":"Der vollständige Wiederherstellungsworkflow: vom Auswählen eines Archivs bis zum Arbeitshost. Dokumentiert die Kompatibilitätsprüfung, die beiden Wiederherstellungsmodi, den On-Boot-Dispatcher, den Post-Boot-Reinstallationspass und die Mechanismen, die Cross-Host- und Cross-Kernel-Wiederherstellungen vorhersehbar machen.",
"section":"Sicherung und Wiederherstellung"
},
"intro":{
"title":"Die Wiederherstellung reproduziert die Quelle, nicht nur die Dateien",
"body":"Ein ProxMenux-Backup wiederherzustellen umfasst mehr als das Entpacken von Dateien. Vor Änderungen wertet die Wiederherstellung das Manifest aus, erkennt Unterschiede zwischen Quelle und Ziel, schließt möglicherweise startgefährdende Pfade aus und passt Benutzereinstellungen an, die nicht unverändert kopiert werden können. Nach dem erforderlichen Neustart versucht sie, die erfassten unterstützten Komponenten (NVIDIA-Treiber, Coral-TPU und GPU-Werkzeuge) für den laufenden Zielkernel neu zu installieren. Ein ausgewähltes Archiv steuert Kompatibilitätsprüfung, Pfadklassifizierung und die Arbeiten beim und nach dem Start. Prüfen Sie die Komponentenergebnisse und Protokolle."
},
"threeActions":{
"heading":"Drei Aktionen auf einem Backup",
"intro":"Durch Auswählen eines Backups aus der Liste wird ein Menü mit drei Aktionen geöffnet.",
"actionRows":[
{
"action":"Ansicht",
"detail":"Öffnet eine schreibgeschützte Ansicht des Archivs: manifest.json-Inhalte (Quellhostname, PVE-Version, Kernel, Hardware, installierte Komponenten), die Liste der Pfade innerhalb von <code>rootfs/</code> und ein Vergleich dessen, was sich auf dem aktuellen Host ändern würde, wenn das Backup angewendet würde."
},
{
"action":"Herunterladen",
"detail":"Exportiert das Archiv als tragbare <code>.tar.zst</code>-Datei (tar komprimiert mit zstd). Es kann auf jedem Linux-System mit <code>tar --zstd -xf FILE.tar.zst</code> extrahiert werden, oder auf macOS / Windows mit jedem Tool, das zstd unterstützt (7-Zip, PeaZip, Keka ...). Der extrahierte Baum enthält <code>manifest.json</code>, <code>metadata/</code> und <code>rootfs/</code> - genau das gleiche Layout, das die Wiederherstellung verbraucht. Nützlich für die Offline-Inspektion oder für die Wiederherstellung auf einem Host ohne Zugriff auf das ursprüngliche Ziel (PBS, Borg)."
},
{
"action":"Wiederherstellen",
"detail":"Der Schreibpfad. Extrahiert das Archiv in ein Staging-Verzeichnis, führt die Kompatibilitätsprüfung aus und präsentiert den Moduswähler (Full oder Custom)."
}
]
},
"compatibilityCheck":{
"heading":"Die Vereinbarkeitsprüfung",
"intro":"Bevor eine Datei geschrieben wird, vergleicht <code>hb_compat_check</code> den im Manifest beschriebenen Zustand mit dem Zielhost. Der Check läuft schreibgeschützt und erzeugt vier unabhängige Ausgänge, die den Rest der Wiederherstellung steuern.",
"outputRows":[
{
"output":"Kernel-Richtungskennzeichen",
"detail":"<code>HB_COMPAT_KERNEL_DIRECTION</code> — eines von <code>same</code>, <code>bk_newer</code> oder <code>bk_older</code>. Vergleicht die Hauptkernelversion des Backups mit der des Ziels. Steuert den Cross-Kernel-Safe-Subset-Filter (feuert nur auf <code>bk_older</code>) und den Hydratationspass, der auf der Cross-Kernel-Seite dokumentiert ist."
},
{
"output":"Liste der Skip Paths",
"detail":"<code>RS_SKIP_PATHS</code> - jeder Pfad, den die Wiederherstellung NICHT anwenden darf. Bevölkert durch zwei Mechanismen: Hardware-Drift (fehlende NIC, fehlende Speicher-ID, ausländischer ZFS-Pool) und - wenn die Richtung <code>bk_older</code> ist - die kernübergreifende Liste der unsicheren Pfade."
},
{
"output":"NIC-Remapplan",
"detail":"Wenn ein NIC auf dem Ziel den gleichen MAC wie auf der Quelle, aber einen anderen Namen hat (typischerweise nach einem Motherboard-Swap), registriert die Kompatibilitätsprüfung einen Umbenennungsplan (<code>HB_NIC_REMAP</code>), der <code>/etc/network/interfaces</code> während der Wiederherstellung umschreibt."
},
{
"output":"Rollback-Plan",
"detail":"Berechnet durch <code>compute_rollback_plan.sh</code>. Listet VMs, LXCs und Komponenten auf, die auf dem Ziel, aber nicht im Backup vorhanden sind. Im Bestätigungsdialog kann das Entfernen zusätzlicher Gäste vor dem Neustart gewählt werden. Komponenten müssen manuell entfernt werden; auch das Löschen von Gästen kann scheitern. Eine exakte Übereinstimmung wird daher nicht garantiert."
}
],
"reportBody":"Der Check sendet auch einen strukturierten Bericht (<code>HB_COMPAT_RESULTS</code>) aus, der als PASS / INFO / WARN / FAIL kategorisiert ist. WARN- und FAIL-Einträge tauchen im Pre-Restore-Bereich auf; die Wiederherstellung weigert sich, nur dann fortzufahren, wenn ein FAIL vorhanden ist, den der Benutzer nicht durch Klicken auf Weiter beheben kann."
},
"twoModes":{
"heading":"Vollständige Wiederherstellung vs Custom Wiederherstellung",
"intro":"Nach der Kompatibilitätsprüfung erscheint die Modusauswahl. Sie bestimmt, <em>was</em> angewendet wird und nicht, <em>wie</em>: Beide Modi verwenden denselben Ablauf.",
"modeRows":[
{
"mode":"Vollständige Wiederherstellung",
"detail":"Wendet jeden Pfad im Archiv an, der die Drift- und Kreuzkernfilter überlebt. Führt auch die Paketinstallation und den automatischen Komponentenneuinstallationspass aus. Dies ist der Standard und die empfohlene Wahl - das Ziel ist es, die Quelle zu reproduzieren, nicht Stücke auszuwählen."
},
{
"mode":"Benutzerdefinierte Wiederherstellung",
"detail":"Öffnet eine Checkliste, die jeden Pfad zeigt, den das Archiv führt. Der Benutzer tickt eine Teilmenge. Durch den Kreuzkernfilter blockierte Pfade erscheinen ausgegraut und können nicht ausgewählt werden. Paketinstallation und automatische Neuinstallation von Komponenten werden standardmäßig im benutzerdefinierten Modus übersprungen - der Benutzer signalisiert, dass er eine teilweise Anwendung und keine vollständige Reproduktion wünscht."
}
]
},
"pathClassification":{
"heading":"Wie Pfade klassifiziert werden",
"intro":"Jeder für die Wiederherstellung ausgewählte Pfad wird von <code>hb_classify_path</code> in eine von drei Kategorien eingestuft. Die Kategorie bestimmt, wann der Pfad auf das System angewendet wird und warum.",
"rows":[
{
"class":"hot",
"detail":"Pfade angewendet <strong>sofort</strong> auf das laufende System. Der Dienst, der sie verbraucht, nimmt die Änderung selbst oder beim nächsten Neuladen auf - kein Neustart erforderlich. Dies ist der Hauptteil eines Backups: <code>/etc/ssh</code>, <code>/etc/apt</code>, <code>/etc/cron.*</code>, <code>/root</code>, <code>/usr/local/bin</code>, allgemeine Servicekonfigurationsdateien usw."
"detail":"Pfade, die dieser Ablauf für den <strong>nächsten Start</strong> zurückstellt, statt sie <strong>sofort</strong> anzuwenden. Sie betreffen die Startkonfiguration: Die Bootloader-Erzeugung liest <code>/etc/default/grub</code>, das Einhängen nutzt <code>/etc/fstab</code> und das Laden von Modulen <code>/etc/modules</code>. Nach dem Neustart werden die vorgemerkten Dateien angewendet und die nötigen Startartefakte neu erzeugt. Beispiele: <code>/etc/default/grub</code>, <code>/etc/kernel</code>, <code>/etc/modules</code>, <code>/etc/fstab</code>, <code>/etc/zfs</code>, <code>/etc/modprobe.d</code>."
"detail":"Pfade, die <strong>NICHT im laufenden System angewendet werden</strong>: Ein Schreibzugriff zur Laufzeit könnte den Zustand beschädigen oder die aktive Verbindung trennen. Sie werden vorgemerkt: <code>/etc/network</code> wird früh beim nächsten Start geschrieben, bevor das Netzwerk startet, und <code>/etc/pve</code> schreibt der Post-Boot-Dispatcher, sobald das Cluster-Dateisystem bereit ist. Beispiele: <code>/etc/pve</code> (pmxcfs ist ein aktiver FUSE-Mount mit laufender Clusterkonfiguration), <code>/var/lib/pve-cluster</code> (aktive Clusterdaten, nur zur manuellen Wiederherstellung im Wiederherstellungsverzeichnis abgelegt), <code>/etc/network</code> (könnte die für die SSH-Verbindung genutzte Schnittstelle neu konfigurieren und die Sitzung trennen)."
"intro":"Die komplette Pipeline von der Archivauswahl bis zu einem funktionierenden wiederhergestellten Host. Jede Stufe füttert die nächste; der von früheren Stufen geschriebene Zustand wird von späteren verbraucht.",
