qemu-img¶
Legt Plattenabbilder virtueller Maschinen an, untersucht, vergrößert und wandelt sie um, zum Beispiel
qcow2,rawodervmdk.

Syntax¶
qemu-img info | create | resize | convert | check | snapshot [OPTIONEN] DATEI
Optionen¶
| Befehl | Beschreibung |
|---|---|
info DATEI |
Format, virtuelle Größe und echter Platzbedarf eines Abbilds |
info -U DATEI |
Ein Abbild lesen, das eine laufende VM nutzt |
create -f qcow2 DATEI GRÖSSE |
Ein neues, leeres Abbild anlegen |
create -b BASIS -F qcow2 |
Ein Overlay anlegen, das nur Änderungen an BASIS speichert |
resize DATEI +10G |
Ein Abbild vergrößern (--shrink zum Verkleinern) |
convert -f EIN -O AUS -p |
Zwischen Formaten umwandeln, mit Fortschritt |
check DATEI |
Ein qcow2-Abbild auf Fehler prüfen |
snapshot -l, -c NAME |
Interne Snapshots auflisten oder anlegen |
qcow2 belegt nur so viel Platz, wie tatsächlich geschrieben wurde, und kann Snapshots. raw ist eine schlichte Byte-für-Byte-Kopie einer Platte.
Beispiele¶
Das Abbild einer ausgeschalteten VM untersuchen:
sudo qemu-img info /var/lib/libvirt/images/test.qcow2
image: /var/lib/libvirt/images/test.qcow2
file format: qcow2
virtual size: 10 GiB (10737418240 bytes)
disk size: 1.84 GiB
cluster_size: 65536
Format specific information:
compat: 1.1
compression type: zlib
lazy refcounts: false
refcount bits: 16
corrupt: false
extended l2: false
Child node '/file':
filename: /var/lib/libvirt/images/test.qcow2
protocol type: file
file length: 10 GiB (10739318784 bytes)
disk size: 1.84 GiB
Die VM läuft:
sudo qemu-img info /var/lib/libvirt/images/web01.qcow2
qemu-img: Could not open '/var/lib/libvirt/images/web01.qcow2': Failed to get shared "write" lock
Is another process using the image [/var/lib/libvirt/images/web01.qcow2]?
Zum Lesen ist qemu-img info -U in Ordnung. Für alles, was schreibt, fährst du die VM herunter.
Ein neues Abbild anlegen:
sudo qemu-img create -f qcow2 /var/lib/libvirt/images/data01.qcow2 20G
Formatting '/var/lib/libvirt/images/data01.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=21474836480 lazy_refcounts=off refcount_bits=16
Einer VM 10 GB mehr geben:
sudo virsh shutdown test
sudo qemu-img resize /var/lib/libvirt/images/test.qcow2 +10G
Domain 'test' is being shutdown
Image resized.
Verkleinern ist abgesichert:
sudo qemu-img resize /var/lib/libvirt/images/test.qcow2 5G
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.
Eine VMware-Platte umwandeln:
sudo qemu-img convert -p -f vmdk -O qcow2 legacy-app.vmdk /var/lib/libvirt/images/legacy-app.qcow2
(100.00/100%)
Test-VMs aus einem Basisabbild (Overlay):
cd /var/lib/libvirt/images
sudo qemu-img create -f qcow2 -b debian-13-base.qcow2 -F qcow2 test2.qcow2
Formatting 'test2.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=21474836480 backing_file=debian-13-base.qcow2 backing_fmt=qcow2 lazy_refcounts=off refcount_bits=16
test2.qcow2 ist anfangs winzig und speichert nur, was die VM ändert. Das Basisabbild darf danach nicht mehr verändert werden.
Ein Abbild auf Fehler prüfen:
sudo qemu-img check /var/lib/libvirt/images/test.qcow2
No errors were found on the image.
30148/327680 = 9.20% allocated, 2.31% fragmented, 0.00% compressed clusters
Image end offset: 1977745408
Wann brauche ich das?¶
- Um zu prüfen, wie groß ein Abbild wirklich ist und ob es eine Basisdatei hat
- Um einer VM mehr Plattenplatz zu geben
- Um VMs von VMware oder Hyper-V (
vmdk,vhdx) nach KVM umzuziehen
Nach resize in der VM
Das Abbild ist größer, Partition und Dateisystem noch nicht. Führe in der VM
sudo growpart /dev/vda 1 und resize2fs bzw.
xfs_growfs aus.
Nie ein Abbild ändern, während die VM läuft
resize, convert in dieselbe Datei, snapshot -c oder check -r bei laufender VM
zerstören das Abbild. Fahr die VM vorher herunter; qemu-img verweigert sich zum
Schutz mit einem Lock-Fehler.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Paket | qemu-utils |
qemu-utils |
qemu-img |
qemu-img |
Verwandte Befehle¶
virsh · virt-install · resize2fs · du