Tag 8: Lebenszyklus, Snapshots und Backups
Ziel: VMs einen Neustart des Hosts überleben lassen, Zustände mit Snapshots festhalten und zurückholen, laufende VMs sichern, auch inkrementell. · Dauer: ca. 120 min · Voraussetzung: Tag 7
Briefing
- Autostart startet eine VM, sobald libvirtd startet.
Was beim Herunterfahren des Hosts passiert, regelt der Dienst
libvirt-guests. - Interner Snapshot: Steckt in der qcow2-Datei selbst, auf Wunsch mit RAM-Inhalt. Zurückspielen geht mit einem Befehl. Nur für qcow2.
- Externer Snapshot: Friert die Platte ein und legt
ein neues Overlay darüber, genau wie in Tag 2. Zurück in eine Datei
kommst du mit
blockcommit. - Backup:
backup-beginkopiert eine laufende Platte in eine eigenständige Datei. Mit Checkpoints kopiert das nächste Backup nur die geänderten Blöcke.
interner Snapshot web1.qcow2 [Daten | Snapshot vor-update]
externer Snapshot noble ◄── web1.qcow2 ◄── web1.vor-umbau (Schreiben nur oben)
blockcommit web1.vor-umbau ──► web1.qcow2, dann pivot
Backup web1-voll.qcow2 (alles) + web1-inkr1.qcow2 (nur Änderungen seit cp1)
Drill 1: Autostart und Neustart des Hosts
virsh autostart db
virsh autostart notes
virsh list --all --autostartErwartet:
Domain 'db' marked as autostarted
Domain 'notes' marked as autostarted
Id Name State
-----------------------
20 notes running
21 db running
Was beim Herunterfahren des Hosts passiert, steht im Skript von
libvirt-guests:
grep -E "^ON_BOOT|^ON_SHUTDOWN" /usr/lib/libvirt/libvirt-guests.shErwartet:
ON_BOOT="ignore"
ON_SHUTDOWN="shutdown"
Ubuntu fährt alle Gäste sauber herunter und startet danach nur die mit Autostart. Jetzt der Versuch:
sudo systemctl rebootNach einer Minute wieder anmelden:
virsh list --all
sudo journalctl -b -u libvirtd --no-pager | grep -i autostartErwartet:
Id Name State
------------------------
2 notes running
- db shut off
- web1 shut off
- web2 shut off
- web3 shut off
… libvirtd[869]: internal error: Failed to autostart VM 'db': Cannot access storage file '/dev/vgkvm/db-daten': No such file or directory
notes läuft, db nicht. Die Warnung aus Tag
5 ist eingetreten: Das Loop-Gerät fehlt, die Volume-Group ist nicht da,
und der Pool vgkvm ist inaktiv. Abhilfe ist eine
systemd-Unit, die das Loop-Gerät vor libvirtd anlegt:
sudo tee /etc/systemd/system/kvm-lvm-loop.service > /dev/null <<'EOF'
[Unit]
Description=Loop-Geraet fuer den LVM-Pool vgkvm
After=local-fs.target
Before=libvirtd.service
[Service]
Type=oneshot
ExecStart=/usr/sbin/losetup -f /var/lib/kvm-lvm.img
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now kvm-lvm-loop.service
losetup -aErwartet:
Created symlink /etc/systemd/system/multi-user.target.wants/kvm-lvm-loop.service → /etc/systemd/system/kvm-lvm-loop.service.
/dev/loop0: []: (/var/lib/kvm-lvm.img)
Jetzt darf auch der Pool automatisch starten:
virsh pool-start vgkvm
virsh pool-autostart vgkvm
virsh start dbErwartet:
Pool vgkvm started
Pool vgkvm marked as autostarted
Domain 'db' started
Und noch einmal neu starten:
sudo systemctl rebootvirsh list --allErwartet:
Id Name State
------------------------
1 db running
2 notes running
- web1 shut off
- web2 shut off
- web3 shut off
Auf kvm2 prüfst du nach ein bis zwei Minuten die Anwendung:
curl -s 172.16.0.81:8080/notes; echoErwartet:
[{"id":"cf22f506-42d4-41d5-be58-476e8ac6abf3","text":"Hallo KVM"}]
web1 brauchst du gleich wieder:
virsh start web1Fortschritt speichern? Kostenlos registrieren
Drill 2: Interne Snapshots
Warte, bis ssh ubuntu@web1 true klappt. Ein Snapshot
mitten im Booten hält genau diesen halb gebooteten Zustand fest.
virsh snapshot-create-as web1 vor-update --description "vor dem Umbau"
virsh snapshot-list web1Erwartet:
Domain snapshot vor-update created
Name Creation Time State
---------------------------------------------------
vor-update 2026-11-13 16:19:59 +0000 running
State running heißt: Der Snapshot enthält auch den RAM.
Jetzt etwas kaputt machen:
ssh ubuntu@web1 "echo kaputt | sudo tee /var/www/html/index.html"
time virsh snapshot-revert web1 vor-update
ssh ubuntu@web1 "curl -s localhost; uptime"Erwartet (gekürzt):
kaputt
Domain snapshot vor-update reverted
real 0m7.064s
web1 aus cloud-init
16:19:49 up 0 min, 1 user, load average: 2.02, 0.52, 0.18
Die VM läuft weiter, als wäre nichts gewesen. Sogar die Uhr im Gast steht auf dem Stand des Snapshots (16:19:49 Gastzeit), bis NTP sie korrigiert.
Bei db geht das nicht:
virsh snapshot-create-as db testErwartet:
error: unsupported configuration: internal snapshot for disk vdb unsupported for storage type raw
Ein LV ist kein qcow2. Interne Snapshots gibt es nur, wenn alle Platten qcow2 sind.
virsh snapshot-delete web1 vor-updateErwartet:
Domain snapshot vor-update deleted
Fortschritt speichern? Kostenlos registrieren
Drill 3: Externe Snapshots und blockcommit
Ein externer Snapshot nur für vda, die Datenplatte
bleibt außen vor:
virsh snapshot-create-as web1 vor-umbau --disk-only --atomic \
--diskspec vda,snapshot=external --diskspec vdb,snapshot=no
virsh domblklist web1Erwartet:
Domain snapshot vor-umbau created
Target Source
----------------------------------------------------
vda /var/lib/libvirt/images/web1.vor-umbau
vdb /var/lib/libvirt/images/daten-web1.qcow2
sda -
Ab jetzt landet jeder Schreibzugriff in web1.vor-umbau.
web1.qcow2 ist eingefroren und kann in Ruhe kopiert werden.
Das ist der klassische Weg, eine laufende VM zu sichern.
ssh ubuntu@web1 "echo web1 nach Umbau 2 | sudo tee /var/www/html/index.html; sync"Ausprobiert:
virsh snapshot-revert web1 vor-umbauscheitert mitInvalid target domain state 'disk-snapshot'. Refusing snapshot reversion, auch bei ausgeschalteter VM. Einen Disk-only-Snapshot spielt libvirt nicht zurück. Wer zurück will, nimmt einen internen Snapshot.
Die Änderung soll bleiben. blockcommit schreibt das
Overlay in die Datei darunter und schaltet die VM im laufenden Betrieb
darauf um:
virsh blockcommit web1 vda --active --shallow --pivot --verbose
virsh domblklist web1Erwartet:
Block commit: [25.61 %]Block commit: [100.00 %]
Successfully pivoted
Target Source
----------------------------------------------------
vda /var/lib/libvirt/images/web1.qcow2
vdb /var/lib/libvirt/images/daten-web1.qcow2
sda -
| Option | Bedeutung |
|---|---|
--active |
führt das aktive Overlay zusammen, in das die VM gerade schreibt |
--shallow |
nur eine Stufe tiefer, in web1.qcow2 |
--pivot |
danach auf die untere Datei umschalten |
Ausprobiert: Ohne
--shallowwillblockcommitbis ganz nach unten schreiben, inbasis/noble.qcow2, die Basis aller VMs. Der Befehl scheiterte mitCould not open '/var/lib/libvirt/images/basis/noble.qcow2': Permission denied. Gerettet hat daschmod 444aus Tag 4.
Übrig sind der Eintrag in der Snapshot-Liste und die Overlay-Datei. Beides räumst du selbst weg:
virsh snapshot-delete web1 vor-umbau --metadata
virsh pool-refresh default
virsh vol-delete web1.vor-umbau --pool default
ssh ubuntu@web1 "curl -s localhost"Erwartet:
Domain snapshot vor-umbau deleted
Pool default refreshed
Vol web1.vor-umbau deleted
web1 nach Umbau 2
Achtung:
vol-deleteerst nach dem Pivot. Vorher ist das Overlay die aktive Platte. QEMU hält die gelöschte Datei zwar offen, aber nach dem nächsten Ausschalten ist alles darin verloren.pool-refreshist nötig, weil der Pool die Datei des Snapshots noch nicht kennt.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Ein Backup im laufenden Betrieb
virsh backup-begin web1
virsh domjobinfo web1Erwartet (gekürzt):
Backup started
Job type: Unbounded
Operation: Backup
Time elapsed: 2762 ms
File processed: 5.292 GiB
File remaining: 8.708 GiB
File total: 14.000 GiB
Ohne weitere Angaben sichert libvirt alle Platten neben die
Originale, mit einem Zeitstempel als Endung. 14 GiB sind die virtuellen
Größen von vda (10) und vdb (4). Nach einer
halben Minute:
virsh domjobinfo web1 --completed
sudo ls -l /var/lib/libvirt/images/ | grep -E "web1"Erwartet (gekürzt):
Job type: Completed
Operation: Backup
Time elapsed: 15131 ms
…
-rw------- 1 libvirt-qemu kvm 327755 Nov 13 16:20 daten-web1.qcow2
-rw------- 1 root root 786432 Nov 13 16:28 daten-web1.qcow2.1794587300
-rw------- 1 libvirt-qemu kvm 868352000 Nov 13 16:28 web1.qcow2
-rw------- 1 root root 2229403648 Nov 13 16:28 web1.qcow2.1794587300
Das Backup von vda ist 2,1 GiB groß, mehr als
web1.qcow2. Es enthält die ganze Kette samt Basis und
braucht nichts anderes, um zu booten.
Achtung:
domjobinfo --completedzeigt die Werte nur einmal. Beim zweiten Aufruf ist die Liste leer. Wer sie behalten will, ergänzt--keep-completed.
Die beiden Dateien sind nur ein Test:
sudo rm /var/lib/libvirt/images/web1.qcow2.1794587300 \
/var/lib/libvirt/images/daten-web1.qcow2.1794587300Fortschritt speichern? Kostenlos registrieren
Drill 5: Voll und inkrementell
Für eigene Ziele und für inkrementelle Backups braucht
backup-begin zwei XML-Dateien: eine für das Backup, eine
für den Checkpoint. Der Checkpoint merkt sich ab diesem
Moment, welche Blöcke sich ändern.
mkdir -p ~/kvm-lab/tag08
cd ~/kvm-lab/tag08
cat > voll.xml <<'EOF'
<domainbackup>
<disks>
<disk name="vda" type="file">
<target file="/var/lib/libvirt/lab/web1-voll.qcow2"/>
<driver type="qcow2"/>
</disk>
<disk name="vdb" backup="no"/>
</disks>
</domainbackup>
EOF
cat > cp1.xml <<'EOF'
<domaincheckpoint>
<name>cp1</name>
<disks>
<disk name="vda"/>
<disk name="vdb" checkpoint="no"/>
</disks>
</domaincheckpoint>
EOFAusprobiert: Ohne den
disks-Block incp1.xmlgilt der Checkpoint für alle Platten. Dann scheitertbackup-beginmitCannot store dirty bitmaps in qcow2 v2 files.daten-web1.qcow2stammt ausvol-create-asund hat das alte Format (compat: 0.10). Die Änderungsliste wird als Bitmap in der Datei gespeichert, und das kann erst qcow2 v3 (compat: 1.1).
virsh backup-begin web1 voll.xml cp1.xmlNach einer halben Minute:
virsh checkpoint-list web1
sudo ls -l /var/lib/libvirt/lab/Erwartet (gekürzt):
Name Creation Time
-----------------------------------
cp1 2026-11-13 16:34:40 +0000
-rw------- 1 root root 2229469184 Nov 13 16:34 web1-voll.qcow2
Jetzt eine Änderung und das zweite Backup, nur mit den Blöcken seit
cp1:
ssh ubuntu@web1 "echo web1 nach dem Backup | sudo tee /var/www/html/index.html; sync"
cat > inkr.xml <<'EOF'
<domainbackup>
<incremental>cp1</incremental>
<disks>
<disk name="vda" type="file">
<target file="/var/lib/libvirt/lab/web1-inkr1.qcow2"/>
<driver type="qcow2"/>
</disk>
<disk name="vdb" backup="no"/>
</disks>
</domainbackup>
EOF
cat > cp2.xml <<'EOF'
<domaincheckpoint>
<name>cp2</name>
<disks>
<disk name="vda"/>
<disk name="vdb" checkpoint="no"/>
</disks>
</domaincheckpoint>
EOF
cat inkr.xmlErwartet:
web1 nach dem Backup
<domainbackup>
<incremental>cp1</incremental>
<disks>
<disk name="vda" type="file">
<target file="/var/lib/libvirt/lab/web1-inkr1.qcow2"/>
<driver type="qcow2"/>
</disk>
<disk name="vdb" backup="no"/>
</disks>
</domainbackup>
virsh backup-begin web1 inkr.xml cp2.xml
sleep 10
virsh domjobinfo web1 --completed
virsh checkpoint-list web1
sudo ls -l /var/lib/libvirt/lab/Erwartet (gekürzt):
Backup started
Job type: Completed
Time elapsed: 383 ms
File total: 4.875 MiB
Name Creation Time
-----------------------------------
cp1 2026-11-13 16:34:40 +0000
cp2 2026-11-13 16:34:59 +0000
-rw------- 1 root root 5701632 Nov 13 16:34 web1-inkr1.qcow2
-rw------- 1 root root 2229469184 Nov 13 16:34 web1-voll.qcow2
Unter einer halben Sekunde, knapp 5 MiB statt 2 GiB. Das nächste
Backup nennt <incremental>cp2</incremental> und
einen neuen Checkpoint cp3.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Wiederherstellen
Das Inkrement enthält nur geänderte Blöcke. Erst über dem Vollbackup
ergibt es eine ganze Platte. Die Verbindung stellst du mit
rebase -u aus Tag 2 her:
cd /var/lib/libvirt/lab
sudo virt-cat -a web1-voll.qcow2 /var/www/html/index.html
sudo qemu-img rebase -u -b web1-voll.qcow2 -F qcow2 web1-inkr1.qcow2
sudo virt-cat -a web1-inkr1.qcow2 /var/www/html/index.htmlErwartet:
web1 nach Umbau 2
web1 nach dem Backup
Das Vollbackup kennt den Stand bei cp1, die Kette den
Stand bei cp2. Für eine Wiederherstellung wird die Kette zu
einer Datei:
sudo qemu-img convert -O qcow2 web1-inkr1.qcow2 web1-restore.qcow2
sudo qemu-img info web1-restore.qcow2 | grep -E "disk size|backing"
sudo virt-cat -a web1-restore.qcow2 /var/www/html/index.htmlErwartet:
disk size: 2.08 GiB
web1 nach dem Backup
Keine backing-Zeile: web1-restore.qcow2
steht für sich und könnte web1.qcow2 ersetzen.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
systemctl is-enabled kvm-lvm-loop.serviceErwartet: enabled.
virsh list --all --autostartErwartet: db und notes.
virsh snapshot-list web1Erwartet: eine leere Liste.
virsh checkpoint-list web1Erwartet: cp1 und cp2.
Challenge
Sichere die Datenplatte von db, also das LV, im
laufenden Betrieb nach /var/lib/libvirt/lab/db-daten.qcow2.
Postgres soll dabei ein sauberes Dateisystem hinterlassen. Prüfe, dass
im Backup das Datenverzeichnis von Postgres liegt.
Hinweis: Der Gast-Agent kann Dateisysteme einfrieren. Eingefroren sein muss nur der Moment, in dem das Backup startet.
Lösung
cd ~/kvm-lab/tag08
cat > db-backup.xml <<'EOF'
<domainbackup>
<disks>
<disk name="vda" backup="no"/>
<disk name="vdb" type="file">
<target file="/var/lib/libvirt/lab/db-daten.qcow2"/>
<driver type="qcow2"/>
</disk>
</disks>
</domainbackup>
EOF
virsh domfsfreeze db
virsh backup-begin db db-backup.xml
virsh domfsthaw dbErwartet:
Froze 3 filesystem(s)
Backup started
Thawed 3 filesystem(s)
backup-begin legt den Stand beim Start fest und kopiert
danach im Hintergrund. Das Dateisystem darf deshalb sofort wieder
laufen. Nach 20 Sekunden:
virsh domjobinfo db --completed
sudo virt-ls -a /var/lib/libvirt/lab/db-daten.qcow2 -m /dev/sda /16/main | head -3Erwartet (gekürzt):
Job type: Completed
Operation: Backup
Time elapsed: 18070 ms
File processed: 5.000 GiB
…
PG_VERSION
base
global
Das LV hat keine Lücken, die qcow2 erkennen könnte. libvirt
verarbeitet deshalb volle 5 GiB. Für Datenbanken ist ein logisches
Backup (pg_dump) zusätzlich Pflicht: Es überlebt auch einen
Versionswechsel von Postgres.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Backup-Software:
virtnbdbackupnutzt genau diese Schnittstelle: Checkpoints und Pull-Modus über NBD statt Dateien. Proxmox Backup Server baut auf denselben QEMU-Bausteinen auf (Dirty Bitmaps), aber ohne libvirt. - Konsistenz:
domfsfreezeist der kleinste Schritt. Applikationskonsistenz heißt, die Anwendung vorher zu informieren (Hooks im Gast-Agenten unter/etc/qemu/fsfreeze-hook.d). - Snapshots sind keine Backups: Ein interner Snapshot liegt in derselben Datei. Geht die Platte kaputt, sind beide weg.
- 3-2-1: drei Kopien, zwei Medien, eine außer Haus.
Die Dateien aus
backup-beginsind nur die erste Kopie.