Anhang A: Spickzettel
Alles auf einen Blick, sortiert nach Thema.
Das Lab
| Was | Wo |
|---|---|
| kvm1 | 172.16.0.182, Bridge br0 mit fester Adresse (Tag
6) |
| kvm2 | 172.16.0.123, ab Tag 7 zweiter Host |
Netz default |
NAT, 192.168.122.0/24, virbr0 |
Netz intern |
isoliert, 10.10.10.0/24, virbr1, Domain
intern, db .20, notes .30 |
Netz lan |
Bridge-Netz auf br0, Adressen vom LAN |
| Pools | default, basis, boot-scratch,
lab, vgkvm (LVM auf Loop),
nfs |
| Basis-Image | /var/lib/libvirt/images/basis/noble.qcow2,
chmod 444 |
| Logs | /var/log/libvirt/qemu/<vm>.log,
journalctl -u libvirtd, journalctl -k |
| Cockpit | https://172.16.0.182:9090, ubuntu /
lab-console-pw-123 |
| notes-api | http://<LAN-IP von notes>:8080, API-Schlüssel
lab-api-key-123 |
QEMU und qemu-img
| Aufgabe | Befehl |
|---|---|
| VM von Hand | qemu-system-x86_64 -enable-kvm -cpu host -m 1024 -smp 2 -drive file=…,if=virtio -nic user,hostfwd=tcp::2222-:22 -nographic |
| Monitor | Strg+A c, info kvm, info block; zurück mit
Strg+A c |
| Platte | qemu-img create -f qcow2 x.qcow2 10G |
| Overlay | qemu-img create -f qcow2 -b basis.qcow2 -F qcow2 x.qcow2 |
| Infos | qemu-img info [-U] --backing-chain x.qcow2 |
| Umwandeln | qemu-img convert -O qcow2 [-c] quelle ziel |
| Snapshot intern | qemu-img snapshot -c/-l/-a/-d name x.qcow2 |
| Basis umhängen | qemu-img rebase -u -b neu.qcow2 -F qcow2 x.qcow2 |
| Größe | qemu-img resize x.qcow2 +5G |
| Seed-ISO | cloud-localds seed.iso user-data [meta-data] |
virsh nach Objekt
| Objekt | Häufig |
|---|---|
| Domain | list --all, define,
undefine [--remove-all-storage], start,
shutdown, destroy, reboot,
autostart |
| Domain-Infos | dominfo, dumpxml [--inactive],
domblklist, domiflist,
domifaddr [--source agent],
domstate --reason |
| Ressourcen | setmem --live, setmaxmem --config,
setvcpus --config [--maximum], vcpupin,
emulatorpin, iothreadadd |
| Platten | attach-disk … --subdriver qcow2 --persistent,
blockresize,
blockcommit --active --shallow --pivot |
| Netzkarten | attach-interface … --model virtio --persistent,
detach-interface <typ> --mac … |
| Snapshots | snapshot-create-as [--disk-only --atomic --diskspec …],
snapshot-list, snapshot-revert,
snapshot-delete [--metadata] |
| Backups | backup-begin [backup.xml checkpoint.xml],
domjobinfo --completed, checkpoint-list |
| Gast-Agent | guestinfo, domfsinfo,
set-user-password,
domfsfreeze/domfsthaw,
qemu-agent-command |
| Netze | net-list --all, net-define,
net-start, net-autostart,
net-update … ip-dhcp-host,
net-dhcp-leases |
| Pools | pool-define-as, pool-build,
pool-start, pool-autostart,
pool-refresh, vol-list,
vol-create-as, vol-delete |
| Migration | migrate --live|--offline [--persistent --undefinesource] [--copy-storage-all] vm qemu+ssh://ziel/system |
| Beobachten | event --all --loop, domstats,
dommemstat, virt-top |
Werkzeuge rund um virsh
| Werkzeug | Wofür |
|---|---|
virt-install --import --cloud-init user-data=…,meta-data=…,network-config=… |
VM aus Cloud-Image bauen |
virt-install --print-xml --dry-run |
XML ansehen, ohne etwas anzulegen; ohne --dry-run
entsteht die Platte trotzdem (Tag 4) |
virt-xml <vm> --edit … /
--add-device … |
Definition ändern ohne Editor |
virt-clone --original … --name … --auto-clone |
volle Kopie einer ausgeschalteten VM |
virt-sysprep -d … --operations machine-id,ssh-hostkeys,customize … |
Klon von Identität befreien |
virt-cat -d vm datei /
virt-ls -a image -m /dev/sda / |
in Platten lesen, ohne zu booten |
virt-admin daemon-log-filters/-outputs |
Debug-Logging zur Laufzeit |
virt-host-validate |
Host prüfen |
Domain-XML: die wichtigsten Stellen
<memory>, <currentMemory>, <vcpu> Speicher und CPUs
<cpu mode='host-passthrough'/> CPU des Hosts durchreichen
<memoryBacking> hugepages, memfd + shared (virtiofs)
<iothreads>, <cputune> IOThreads und Pinning
<on_reboot> destroy in der Installationsphase!
<disk type='file'> Platte; <driver cache='none' io='native' iothread='1'/>
<interface type='network'> Netzkarte; <mac address='52:54:00:…'/>
<filesystem><driver type='virtiofs'/> Freigabe vom Host
<channel> org.qemu.guest_agent.0 Kanal für den Gast-Agenten
<graphics type='spice' listen='127.0.0.1'> Konsole
<seclabel model='apparmor'|'dac'> Sicherheitslabel
Typische Fehler
| Meldung | Ursache | Tag |
|---|---|---|
Cannot access storage file '…' (as uid:64055, …): Permission denied
bei Platte in /home |
libvirt-qemu darf dort nicht lesen |
3 |
VM aus nach virsh reboot |
erste Installationsphase, on_reboot destroy |
4 |
| Klon ohne IP | netplan an alte MAC gebunden | 5 |
Failed to autostart VM … /dev/vgkvm/… |
Loop-Gerät fehlt nach Neustart | 8 |
Could not open … noble.qcow2 bei
blockcommit |
ohne --shallow ins Basis-Image |
8 |
Cannot store dirty bitmaps in qcow2 v2 files |
Platte mit compat: 0.10 im Checkpoint |
8 |
Migration disabled: vhost-user backend … |
virtiofs verhindert Snapshot mit RAM und Migration | 9 |
io='native' needs either no disk cache… |
io=native nur mit cache=none |
10 |
unable to map backing store for guest RAM |
Hugepages nicht reserviert | 10 |
mount: … bad option beim NFS-Pool |
nfs-common fehlt |
12 |
Unable to resolve address 'kvm2' service '49152' |
Zielname nicht in /etc/hosts |
12 |
Network not found: … 'intern' bei Migration |
Netz fehlt auf dem Ziel | 12 |
network 'test' is not active |
Netz definiert, nicht gestartet | 14 |
VMs ohne Netz nach
net-destroy/net-start |
Tap-Geräte hängen nicht mehr an der Bridge | 15 |