Zum Inhalt springen
Trainingslager IT-Trainingslager

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-begin kopiert 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 --autostart

Erwartet:

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.sh

Erwartet:

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 reboot

Nach einer Minute wieder anmelden:

virsh list --all
sudo journalctl -b -u libvirtd --no-pager | grep -i autostart

Erwartet:

 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 -a

Erwartet:

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 db

Erwartet:

Pool vgkvm started

Pool vgkvm marked as autostarted

Domain 'db' started

Und noch einmal neu starten:

sudo systemctl reboot
virsh list --all

Erwartet:

 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; echo

Erwartet:

[{"id":"cf22f506-42d4-41d5-be58-476e8ac6abf3","text":"Hallo KVM"}]

web1 brauchst du gleich wieder:

virsh start web1

Fortschritt 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 web1

Erwartet:

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 test

Erwartet:

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-update

Erwartet:

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 web1

Erwartet:

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-umbau scheitert mit Invalid 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 web1

Erwartet:

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 --shallow will blockcommit bis ganz nach unten schreiben, in basis/noble.qcow2, die Basis aller VMs. Der Befehl scheiterte mit Could not open '/var/lib/libvirt/images/basis/noble.qcow2': Permission denied. Gerettet hat das chmod 444 aus 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-delete erst 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-refresh ist 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 web1

Erwartet (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 --completed zeigt 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.1794587300

Fortschritt 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>
EOF

Ausprobiert: Ohne den disks-Block in cp1.xml gilt der Checkpoint für alle Platten. Dann scheitert backup-begin mit Cannot store dirty bitmaps in qcow2 v2 files. daten-web1.qcow2 stammt aus vol-create-as und 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.xml

Nach 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.xml

Erwartet:

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.html

Erwartet:

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.html

Erwartet:

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.service

Erwartet: enabled.

virsh list --all --autostart

Erwartet: db und notes.

virsh snapshot-list web1

Erwartet: eine leere Liste.

virsh checkpoint-list web1

Erwartet: 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 db

Erwartet:

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 -3

Erwartet (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: virtnbdbackup nutzt 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: domfsfreeze ist 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-begin sind nur die erste Kopie.