Dateien nach "/" hochladen

README.md

@@ -1,2 +1,88 @@
-# libvirtbackup
+# Libvirt-VM-Backup und Restore
 
+## Voraussetzungen
+
+Auf dem Ubuntu-Host:
+
+```bash
+sudo apt install rsync libvirt-clients qemu-utils python3
+```
+
+Auf dem Debian-Ziel:
+
+```bash
+sudo apt install qemu-system-x86 qemu-utils libvirt-daemon-system \
+  libvirt-clients ovmf swtpm swtpm-tools rsync python3
+```
+
+## Backup
+
+1. Windows vollständig herunterfahren.
+2. BitLocker-Recovery-Keys separat sichern.
+3. Backup-Datenträger einhängen.
+4. Skript starten:
+
+```bash
+chmod +x libvirt-backup.sh libvirt-restore.sh
+sudo ./libvirt-backup.sh /mnt/backup/libvirt-host
+```
+
+Prüfen:
+
+```bash
+cd /mnt/backup/libvirt-host
+sha256sum -c metadata/SHA256SUMS
+cat metadata/block-sources.txt
+cat metadata/missing-files.txt
+```
+
+`block-sources.txt` muss leer sein, sofern keine LVM-/Block-Devices verwendet
+werden. Enthaltene Blockgeräte sind zusätzlich separat zu sichern.
+
+## Restore
+
+Auf Debian zunächst libvirt/QEMU installieren und den Backup-Datenträger
+einbinden:
+
+```bash
+sudo ./libvirt-restore.sh /mnt/backup/libvirt-host
+```
+
+Standardmäßig überschreibt das Skript keine vorhandenen Dateien oder
+libvirt-Definitionen. Für eine bewusst erzwungene Wiederherstellung:
+
+```bash
+sudo OVERWRITE_FILES=1 REPLACE_DEFINITIONS=1 \
+  ./libvirt-restore.sh /mnt/backup/libvirt-host
+```
+
+Autostart für importierte Objekte setzen:
+
+```bash
+sudo AUTOSTART_OBJECTS=1 ./libvirt-restore.sh /mnt/backup/libvirt-host
+```
+
+Exportierte Host-Interfaces/Bridges werden aus Sicherheitsgründen nicht
+automatisch definiert. Das ist bewusst separat:
+
+```bash
+sudo RESTORE_INTERFACES=1 ./libvirt-restore.sh /mnt/backup/libvirt-host
+```
+
+Bei Bridges ist es häufig besser, die Netzwerkkonfiguration auf Debian mit
+NetworkManager oder systemd-networkd neu aufzubauen.
+
+## Wichtige Grenzen
+
+- Offline-Backup: Die VMs müssen ausgeschaltet sein.
+- File-basierte Images, UEFI-NVRAM und dateibasierte TPM-Zustände werden kopiert.
+- LVM-LVs, ZFS-ZVOLs, Ceph/RBD, iSCSI und sonstige Block-/Netzwerk-Storage-
+  Quellen werden nur dokumentiert.
+- Snapshot-Backing-Chains werden nicht automatisch aufgelöst. Referenzierte
+  Backing-Dateien müssen selbst als Disk-Quelle in der Konfiguration vorkommen
+  oder zusätzlich gesichert werden.
+- Firmwarepfade können sich zwischen Ubuntu und Debian unterscheiden. Bei
+  OVMF-Fehlern das Domain-XML und die auf Debian installierten Firmwaredateien
+  prüfen.
+- Nach dem Restore zuerst nur eine VM starten und insbesondere UEFI, virtuelles
+  TPM, Secure Boot, BitLocker und Netzwerk testen.