Zum Inhalt springen
Trainingslager IT-Trainingslager

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