Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 2: Platten verstehen

Ziel: Raw und qcow2 unterscheiden, VMs als dünne Overlays auf einem gemeinsamen Basis-Image anlegen und Backing Chains prüfen, reparieren und auflösen. · Dauer: ca. 60 min · Voraussetzung: Tag 1

Briefing

  • raw ist die Platte Byte für Byte als Datei. Sie ist schnell und einfach, kann aber keine Snapshots und selbst kein Overlay sein (als Basis taugt sie).
  • qcow2 (QEMU Copy-on-Write, Version 2) speichert nur belegte Blöcke und kann interne Snapshots, Kompression und Backing Files.
  • Ein Overlay ist eine qcow2-Datei, die nur die Änderungen gegenüber einer Basis enthält. Gelesen wird zuerst im Overlay, dann in der Basis. Zehn VMs teilen sich so ein Basis-Image.
  vm-a.qcow2 (Änderungen von A) ─┐
                                 ├──► basis/basis.qcow2 (nur lesen, 593 MiB)
  vm-b.qcow2 (Änderungen von B) ─┘

Drill 1: raw und qcow2

mkdir -p ~/kvm-lab/tag02 && cd ~/kvm-lab/tag02
qemu-img create -f raw platte.raw 10G
qemu-img create -f qcow2 platte.qcow2 10G

Erwartet (gekürzt):

Formatting 'platte.raw', fmt=raw size=10737418240
Formatting 'platte.qcow2', fmt=qcow2 cluster_size=65536 … size=10737418240 …
ls -lh platte.*
du -h platte.*

Erwartet:

-rw-r--r-- 1 ubuntu ubuntu 193K Nov 13 13:03 platte.qcow2
-rw-r--r-- 1 ubuntu ubuntu  10G Nov 13 13:03 platte.raw
196K    platte.qcow2
4.0K    platte.raw
  • ls zeigt bei raw 10 GB, du nur 4 KB. Die Datei ist sparse: Das Dateisystem reserviert keine Blöcke für Nullen. Kopierst du sie unvorsichtig, etwa über ein Netzlaufwerk, werden daraus echte 10 GB.
  • qcow2 ist auch für ls klein. Die Datei wächst erst, wenn der Gast schreibt.
rm platte.*

Fortschritt speichern? Kostenlos registrieren

Drill 2: Umwandeln und komprimieren

qemu-img convert -f qcow2 -O raw ../images/noble-server-cloudimg-amd64.img noble.raw
du -h noble.raw

Erwartet:

1.8G    noble.raw

Das Cloud-Image war als qcow2 nur 593 MB groß. Ubuntu liefert es komprimiert aus. Ausgepackt belegt es 1,8 GB. Zurück mit Kompression:

qemu-img convert -c -f raw -O qcow2 noble.raw komprimiert.qcow2
du -h komprimiert.qcow2

Erwartet:

592M    komprimiert.qcow2

Komprimierte Blöcke liest QEMU langsamer, und alles Neue schreibt der Gast unkomprimiert. -c lohnt sich für Images zum Verteilen, nicht für laufende VMs.

rm noble.raw komprimiert.qcow2

Fortschritt speichern? Kostenlos registrieren

Drill 3: Basis und Overlays

mkdir basis
cp ../images/noble-server-cloudimg-amd64.img basis/basis.qcow2
chmod a-w basis/basis.qcow2
qemu-img create -f qcow2 -b basis/basis.qcow2 -F qcow2 vm-a.qcow2 10G
qemu-img create -f qcow2 -b basis/basis.qcow2 -F qcow2 vm-b.qcow2 10G
  • -b nennt das Backing File, -F dessen Format. Ohne -F verweigern neuere QEMU-Versionen den Dienst, denn ein geratenes Format ist eine Sicherheitslücke.
  • chmod a-w schützt die Basis. Sie darf sich nie mehr ändern, sonst passen die Overlays nicht mehr zu ihr.
  • Der Pfad zur Basis steht so im Overlay, wie du ihn angibst. Ein relativer Pfad gilt relativ zum Overlay.
ls -lh basis/*.qcow2 vm-*.qcow2
qemu-img info --backing-chain vm-a.qcow2

Erwartet (gekürzt):

-r--r--r-- 1 ubuntu ubuntu 593M Nov 13 13:07 basis/basis.qcow2
-rw-r--r-- 1 ubuntu ubuntu 193K Nov 13 13:07 vm-a.qcow2
-rw-r--r-- 1 ubuntu ubuntu 193K Nov 13 13:07 vm-b.qcow2
image: vm-a.qcow2
file format: qcow2
virtual size: 10 GiB (10737418240 bytes)
disk size: 196 KiB
backing file: basis/basis.qcow2
backing file format: qcow2
…
image: basis/basis.qcow2
file format: qcow2
virtual size: 3.5 GiB (3758096384 bytes)
disk size: 593 MiB
…

Zwei VMs mit je 10 GB kosten bisher 593 MiB plus zweimal 196 KiB.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Ein Overlay in Betrieb

Starte vm-a mit dem Seed aus Tag 1, diesmal im Hintergrund:

qemu-system-x86_64 -enable-kvm -cpu host -m 1024 -smp 2 \
  -drive file=vm-a.qcow2,if=virtio \
  -drive file=../tag01/seed.iso,if=virtio,format=raw \
  -nic user,hostfwd=tcp::2222-:22 \
  -display none -daemonize

-display none -daemonize startet die VM ohne Konsole als Hintergrundprozess. Warte etwa eine Minute, dann:

ssh -o StrictHostKeyChecking=no -p 2222 ubuntu@localhost \
  'echo hallo | sudo tee /root/nur-in-a.txt'
ssh -o StrictHostKeyChecking=no -p 2222 ubuntu@localhost sudo poweroff

Erwartet:

hallo

StrictHostKeyChecking=no brauchst du, weil der Gast neue Host-Keys hat, aber unter derselben Adresse wie erste aus Tag 1 lauscht. Nur im Lab.

Der Gast braucht nach poweroff noch einige Sekunden. Warte, bis kein QEMU mehr läuft:

pgrep -a qemu-system

Erwartet: keine Ausgabe.

Ausprobiert: Wer sofort weitermacht, bekommt bei jedem qemu-img-Befehl Failed to get "write" lock und Is another process using the image [vm-a.qcow2]?. QEMU sperrt seine Platten, damit nicht zwei Prozesse gleichzeitig hineinschreiben. Das schützt dich auch davor, eine Platte versehentlich in zwei VMs zu starten.

ls -lh vm-*.qcow2

Erwartet:

-rw-r--r-- 1 ubuntu ubuntu  56M Nov 13 13:09 vm-a.qcow2
-rw-r--r-- 1 ubuntu ubuntu 193K Nov 13 13:07 vm-b.qcow2

Der erste Start mit cloud-init, Logs und deiner Datei hat 56 MB geschrieben, und zwar nur in vm-a. Die Basis und vm-b sind unverändert.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Prüfen und interne Snapshots

qemu-img check vm-a.qcow2

Erwartet:

No errors were found on the image.
869/163840 = 0.53% allocated, 16.57% fragmented, 0.00% compressed clusters
Image end offset: 57999360

check findet Lecks und Fehler nach einem Absturz des Hosts. Mit -r all repariert es sie. Beides nur bei ausgeschalteter VM.

Ein interner Snapshot liegt in derselben Datei:

qemu-img snapshot -c vor-update vm-a.qcow2
qemu-img snapshot -l vm-a.qcow2

Erwartet:

Snapshot list:
ID        TAG               VM SIZE                DATE     VM CLOCK     ICOUNT
1         vor-update            0 B 2026-11-13 13:09:05 00:00:00.000          0

VM SIZE 0 B heißt: Nur die Platte ist gesichert, nicht der RAM. Zurückspringen und löschen:

qemu-img snapshot -a vor-update vm-a.qcow2
qemu-img snapshot -d vor-update vm-a.qcow2

Erwartet: keine Ausgabe. libvirt nutzt dieselben internen Snapshots, kann aber auch den RAM einer laufenden VM mitsichern (Tag 8).

Fortschritt speichern? Kostenlos registrieren

Drill 6: Eine kaputte Kette

Was passiert, wenn jemand die Basis verschiebt?

mkdir neu
mv basis/basis.qcow2 neu/
qemu-img info --backing-chain vm-b.qcow2

Erwartet:

qemu-img: Could not open 'basis/basis.qcow2': Could not open 'basis/basis.qcow2': No such
file or directory

Die VM würde genauso wenig starten. rebase -u schreibt nur den neuen Pfad in das Overlay und rührt keine Daten an (-u für „unsafe“):

qemu-img rebase -u -b neu/basis.qcow2 -F qcow2 vm-a.qcow2
qemu-img rebase -u -b neu/basis.qcow2 -F qcow2 vm-b.qcow2
qemu-img info --backing-chain vm-b.qcow2 | grep -E '^image|^backing file:'

Erwartet:

image: vm-b.qcow2
backing file: neu/basis.qcow2
image: neu/basis.qcow2

Achtung: -u ist nur richtig, wenn die Basis dieselbe Datei ist, nur an einem anderen Ort. Hängst du ein Overlay an eine andere Basis, liest der Gast ein Gemisch aus zwei Platten, und das Dateisystem ist kaputt. Ohne -u gleicht rebase die Inhalte ab, das dauert, ist aber sicher.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Auflösen statt zusammenführen

Du willst vm-a unabhängig von der Basis machen, etwa um sie auf einen anderen Host zu kopieren. Der naheliegende Befehl wäre commit, der die Änderungen in die Basis schreibt:

qemu-img commit vm-a.qcow2

Erwartet:

qemu-img: Could not open 'neu/basis.qcow2': Permission denied

Gut so. Hätte commit die Basis geändert, wäre vm-b jetzt kaputt, denn ihre Änderungen passen nur zur alten Basis. Der richtige Weg ist eine neue, flache Datei:

qemu-img convert -O qcow2 vm-a.qcow2 vm-a-flach.qcow2
qemu-img info vm-a-flach.qcow2 | head -4

Erwartet:

image: vm-a-flach.qcow2
file format: qcow2
virtual size: 10 GiB (10737418240 bytes)
disk size: 1.79 GiB

Keine Zeile backing file mehr. Die Datei ist mit 1,8 GB größer als Basis und Overlay zusammen, weil convert ohne -c unkomprimiert schreibt.

Fortschritt speichern? Kostenlos registrieren

Drill 8: Verkleinern

Vergrößern kennst du aus Tag 1. Verkleinern ist gefährlich, und QEMU sagt das deutlich:

qemu-img resize vm-b.qcow2 5G

Erwartet:

qemu-img: Use the --shrink option to perform a shrink operation.
qemu-img: warning: Shrinking an image will delete all data beyond the shrunken image's
end. Before performing such an operation, make sure there is no important data there.

Erst müssen Dateisystem und Partition im Gast kleiner werden, dann die Datei. In der Praxis legst du lieber eine neue, kleinere Platte an und kopierst die Daten.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

qemu-img info --backing-chain ~/kvm-lab/tag02/vm-b.qcow2 | grep '^image'

Erwartet: zwei Zeilen, vm-b.qcow2 und neu/basis.qcow2. Die Kette ist heil.

ls -l ~/kvm-lab/tag02/neu/basis.qcow2

Erwartet: Die Rechte beginnen mit -r--r--r--, die Basis ist schreibgeschützt.

qemu-img check ~/kvm-lab/tag02/vm-a.qcow2

Erwartet: No errors were found on the image.

Challenge

Lege ein Overlay vm-a-test.qcow2 auf vm-a.qcow2 an, sodass eine Kette aus drei Dateien entsteht. Lass dir die Kette anzeigen und schreibe das Test-Overlay danach mit commit in vm-a zurück.

Hinweis: Diesmal ist commit richtig, denn nur vm-a-test hängt an vm-a.

Lösung

cd ~/kvm-lab/tag02
qemu-img create -f qcow2 -b vm-a.qcow2 -F qcow2 vm-a-test.qcow2
qemu-img info --backing-chain vm-a-test.qcow2 | grep -E '^image|^backing file:'

Erwartet:

image: vm-a-test.qcow2
backing file: vm-a.qcow2
image: vm-a.qcow2
backing file: neu/basis.qcow2
image: neu/basis.qcow2
qemu-img commit vm-a-test.qcow2
rm vm-a-test.qcow2

Erwartet:

Image committed.

commit schreibt die Änderungen eine Ebene nach unten, also in vm-a. Danach ist das Test-Overlay überflüssig. Genau so arbeiten externe Snapshots in libvirt (Tag 8).

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Basis-Images versionieren: Im Betrieb heißt die Basis zum Beispiel noble-2026-11.qcow2 und wird nie überschrieben. Neue Version, neuer Name.
  • raw auf Block-Storage: Auf LVM, Ceph RBD oder SAN nimmst du oft raw, weil das Speichersystem Snapshots und Thin Provisioning selbst kann.
  • Lange Ketten kosten Leistung: Jede Ebene ist ein Nachschlagen mehr. Halte Ketten kurz und führe sie zusammen, wenn sie nicht mehr gebraucht werden.
  • Backups nie von laufenden Dateien kopieren: cp der qcow2-Datei einer laufenden VM ergibt ein inkonsistentes Image. Dafür gibt es virsh backup-begin (Tag 8).