Tag 3: libvirt übernimmt
Ziel: libvirt installieren, die VM aus Tag 1 als libvirt-Domain beschreiben und mit
virshstarten, ansehen und herunterfahren. · Dauer: ca. 60 min · Voraussetzung: Tag 2
Briefing
- libvirtd ist ein Dienst, der QEMU-Prozesse für dich startet und überwacht. Eine VM heißt dort Domain und ist in einer XML-Datei beschrieben.
virshist das Kommandozeilenwerkzeug dazu. Es spricht über eine Connection-URI mit libvirtd:qemu:///systemfür die VMs des Systems,qemu:///sessionfür private VMs deines Benutzers.- Die QEMU-Prozesse laufen nicht mehr unter deinem Namen, sondern als
Benutzer
libvirt-qemu, geschützt durch AppArmor. Das hat Folgen dafür, wo Platten liegen dürfen.
virsh ──► libvirtd ──► qemu-system-x86_64 (Benutzer libvirt-qemu)
│ └─ vda: /var/lib/libvirt/images/erste.qcow2
├─ /etc/libvirt/qemu/erste.xml Definition
└─ Netz default: virbr0 192.168.122.1 (NAT + DHCP)
Drill 1: libvirt installieren
sudo apt-get install -y libvirt-daemon-system libvirt-clients virtinst
sudo usermod -aG libvirt $USER
virsh --versionErwartet:
10.0.0
Melde dich ab und wieder an, damit die Gruppe libvirt
gilt. Dann:
virsh uriErwartet:
qemu:///session
Als normaler Benutzer landet virsh in deiner privaten
Session. Die VMs des Systems siehst du dort nicht. Stelle die
Voreinstellung um:
echo 'export LIBVIRT_DEFAULT_URI=qemu:///system' >> ~/.bashrc
source ~/.bashrc
virsh uriErwartet:
qemu:///system
Ohne die Gruppe libvirt endet derselbe Befehl mit
Failed to connect socket to '/var/run/libvirt/libvirt-sock': Permission denied.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Kann der Host das?
virt-host-validate qemuErwartet (gekürzt):
QEMU: Checking for hardware virtualization : PASS
QEMU: Checking if device /dev/kvm exists : PASS
QEMU: Checking if device /dev/kvm is accessible : PASS
QEMU: Checking if device /dev/vhost-net exists : PASS
…
QEMU: Checking for cgroup 'devices' controller support : WARN (Enable 'devices' …)
QEMU: Checking for device assignment IOMMU support : WARN (No ACPI DMAR table …)
Alles mit PASS zählt. Die Warnungen betreffen cgroup v2,
das keinen eigenen devices-Controller mehr hat, und die
IOMMU, die du nur zum Durchreichen echter Geräte brauchst. Beides darfst
du hier ignorieren.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Das Standardnetz
virsh net-list --all
ip -br a show virbr0Erwartet:
Name State Autostart Persistent
--------------------------------------------
default active yes yes
virbr0 UP 192.168.122.1/24
libvirt bringt ein Netz default mit: die Bridge
virbr0, NAT ins Internet und einen DHCP-Server (dnsmasq)
für 192.168.122.0/24. In Tag 6 baust du eigene Netze.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Die erste Domain
mkdir -p ~/kvm-lab/tag03 && cd ~/kvm-lab/tag03
cat > erste.xml <<'EOF'
<domain type="kvm">
<name>erste</name>
<memory unit="MiB">1024</memory>
<vcpu>2</vcpu>
<os>
<type arch="x86_64" machine="q35">hvm</type>
</os>
<cpu mode="host-passthrough"/>
<devices>
<disk type="file" device="disk">
<driver name="qemu" type="qcow2"/>
<source file="/home/ubuntu/kvm-lab/tag01/erste.qcow2"/>
<target dev="vda" bus="virtio"/>
</disk>
<interface type="network">
<source network="default"/>
<model type="virtio"/>
</interface>
<serial type="pty"/>
<console type="pty"/>
</devices>
</domain>
EOFFast jede Zeile hat ein Gegenstück im QEMU-Aufruf aus Tag 1:
memory ist -m, vcpu ist
-smp, cpu mode="host-passthrough" ist
-cpu host, die disk ist -drive.
Neu sind der Maschinentyp q35 und
interface type="network": Die VM hängt am Netz
default statt im User-Mode-Netz.
virsh define erste.xml
virsh start ersteErwartet:
Domain 'erste' defined from erste.xml
error: Failed to start domain 'erste'
error: Cannot access storage file '/home/ubuntu/kvm-lab/tag01/erste.qcow2' (as uid:64055,
gid:993): Permission denied
define hat geklappt, start nicht. Wer ist
uid 64055?
getent passwd 64055Erwartet:
libvirt-qemu:x:64055:993:Libvirt Qemu,,,:/var/lib/libvirt:/usr/sbin/nologin
QEMU läuft als libvirt-qemu und darf nicht in dein
Home-Verzeichnis. Das ist Absicht: Ein gekaperter QEMU-Prozess soll
möglichst wenig sehen. Platten gehören nach
/var/lib/libvirt/images.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Die Platte an ihren Platz
sudo mv ~/kvm-lab/tag01/erste.qcow2 /var/lib/libvirt/images/
virsh undefine ersteErwartet:
Domain 'erste' has been undefined
undefine löscht nur die Definition, nicht die
Platte.
Ausprobiert: Ohne
undefinescheitert ein zweitesvirsh define erste.xmlmitdomain 'erste' already exists with uuid …. Deine Datei enthält keine UUID, also hält libvirt sie für eine neue Domain mit vergebenem Namen. Im Alltag änderst du Domains mitvirsh edit erste, das öffnet die vollständige XML im Editor.
Schreib die Datei neu, mit dem richtigen Pfad und einer festen MAC-Adresse:
cat > erste.xml <<'EOF'
<domain type="kvm">
<name>erste</name>
<memory unit="MiB">1024</memory>
<vcpu>2</vcpu>
<os>
<type arch="x86_64" machine="q35">hvm</type>
</os>
<cpu mode="host-passthrough"/>
<devices>
<disk type="file" device="disk">
<driver name="qemu" type="qcow2"/>
<source file="/var/lib/libvirt/images/erste.qcow2"/>
<target dev="vda" bus="virtio"/>
</disk>
<interface type="network">
<source network="default"/>
<mac address="52:54:00:12:34:56"/>
<model type="virtio"/>
</interface>
<serial type="pty"/>
<console type="pty"/>
</devices>
</domain>
EOF
virsh define erste.xml
virsh start ersteErwartet:
Domain 'erste' defined from erste.xml
Domain 'erste' started
Warum die feste MAC 52:54:00:12:34:56? Das ist die MAC,
die QEMU in Tag 1 ohne libvirt vergeben hat. Beim ersten Start hat
cloud-init die Netzkonfiguration an genau diese Adresse gebunden:
sudo apt-get install -y libguestfs-tools
virsh destroy erste
sudo virt-cat -a /var/lib/libvirt/images/erste.qcow2 /etc/netplan/50-cloud-init.yaml
virsh start erstedestroy schaltet die VM hart aus, löscht aber nichts
(mehr in Drill 8).
Erwartet (nach dem Herunterladen der Pakete):
network:
version: 2
ethernets:
ens3:
match:
macaddress: "52:54:00:12:34:56"
dhcp4: true
…
Ausprobiert: Ohne
<mac>vergibt libvirt eine zufällige MAC, und netplan im Gast fühlt sich für die neue Karte nicht zuständig. Die VM läuft, bekommt aber nie eine IP-Adresse. Das passiert jedem, der eine Platte von einer VM in eine andere mitnimmt.virt-catliest Dateien direkt aus einer Platte, ohne die VM zu starten. Verlässlich ist das nur bei ausgeschalteter VM, sonst siehst du halb geschriebene Daten.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Wo ist die VM?
Gib dem Gast eine Minute, dann:
virsh list --all
virsh domifaddr ersteErwartet (IPs weichen bei dir ab):
Id Name State
-----------------------
3 erste running
Name MAC address Protocol Address
-------------------------------------------------------------------------------
vnet1 52:54:00:12:34:56 ipv4 192.168.122.76/24
domifaddr fragt den DHCP-Server des Netzes. Bleibt die
Liste leer, ist der Gast noch nicht so weit oder hat keine IP bekommen.
Die gesamte Liste aller Leases zeigt:
virsh net-dhcp-leases defaultErwartet (gekürzt):
Expiry Time MAC address Protocol IP address Hostname …
--------------------------------------------------------------------------------------
2026-11-13 14:17:48 52:54:00:12:34:56 ipv4 192.168.122.76/24 erste …
Jetzt erreichst du den Gast direkt, ohne Portweiterleitung. Setze die
IP aus domifaddr ein:
ssh -o StrictHostKeyChecking=no [email protected] lspciErwartet (gekürzt):
…
01:00.0 Ethernet controller: Red Hat, Inc. Virtio 1.0 network device (rev 01)
03:00.0 SCSI storage controller: Red Hat, Inc. Virtio 1.0 block device (rev 01)
04:00.0 Unclassified device [00ff]: Red Hat, Inc. Virtio 1.0 memory balloon (rev 01)
Den Memory Balloon hat libvirt von sich aus ergänzt. Mehr dazu in der Challenge.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Was libvirt daraus macht
virsh dumpxml erste | head -18
virsh dumpxml erste | wc -lErwartet (gekürzt):
<domain type='kvm' id='3'>
<name>erste</name>
<uuid>387e1a17-29a0-4d2d-a2e6-5da8a969ed39</uuid>
<memory unit='KiB'>1048576</memory>
<currentMemory unit='KiB'>1048576</currentMemory>
<vcpu placement='static'>2</vcpu>
…
<os>
<type arch='x86_64' machine='pc-q35-noble'>hvm</type>
<boot dev='hd'/>
</os>
<cpu mode='host-passthrough' check='none' migratable='on'/>
<clock offset='utc'/>
<on_poweroff>destroy</on_poweroff>
<on_reboot>restart</on_reboot>
<on_crash>destroy</on_crash>
114
Aus 23 Zeilen wurden 114. libvirt füllt alles Fehlende mit
Standardwerten: UUID, Maschinentyp pc-q35-noble, Uhr,
USB-Controller, PCI-Adressen. Die gespeicherte Definition liegt
hier:
sudo ls /etc/libvirt/qemu/Erwartet:
erste.xml
networks
Achtung: Diese Dateien nie direkt bearbeiten. libvirtd liest sie nur beim Start. Änderungen immer über
virsh defineodervirsh edit.
Und die echte QEMU-Befehlszeile steht im Log der Domain:
sudo head -12 /var/log/libvirt/qemu/erste.logErwartet (gekürzt):
…
/usr/bin/qemu-system-x86_64 \
-name guest=erste,debug-threads=on \
-S \
-object '{"qom-type":"secret","id":"masterKey0",…
-machine pc-q35-noble,usb=off,dump-guest-core=off,memory-backend=pc.ram,… \
-accel kvm \
-cpu host,migratable=on \
…
Das ist dein QEMU-Aufruf aus Tag 1, nur sehr viel ausführlicher.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Konsole und Herunterfahren
virsh console ersteDrücke Enter, melde dich als ubuntu mit
lab-console-pw-123 an und wieder ab. Verlassen wird die
Konsole mit Strg+]. Das klappt dank
<serial> und <console> in der XML,
auch wenn das Netz im Gast kaputt ist.
virsh shutdown ersteErwartet:
Domain 'erste' is being shutdown
Warte einige Sekunden, dann:
virsh domstate --reason ersteErwartet:
shut off (shutdown)
| Befehl | Wirkung |
|---|---|
virsh shutdown |
bittet den Gast per ACPI, sich herunterzufahren |
virsh destroy |
beendet QEMU sofort, wie ein gezogener Stecker |
virsh reboot |
bittet den Gast um einen Neustart |
virsh reset |
harter Neustart ohne Herunterfahren |
destroy klingt dramatisch, löscht aber nichts. Die
Definition und die Platte bleiben.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
virsh uriErwartet: qemu:///system.
virsh list --allErwartet: erste mit dem Zustand
shut off.
virsh domblklist ersteErwartet: vda zeigt auf
/var/lib/libvirt/images/erste.qcow2.
Challenge
Gib erste dauerhaft 2 GB RAM und 4 vCPUs, ohne die
XML-Datei anzufassen, und prüfe im Gast die vCPUs.
Hinweis: virsh setmaxmem,
setmem und setvcpus kennen die Option
--config für die gespeicherte Definition. Das Maximum muss
zuerst steigen.
Lösung
virsh setmaxmem erste 2G --config
virsh setmem erste 2G --config
virsh setvcpus erste 4 --config --maximum
virsh setvcpus erste 4 --config
virsh dominfo erste | grep -E 'CPU|memory'Erwartet:
CPU(s): 4
Max memory: 2097152 KiB
Used memory: 2097152 KiB
virsh start erste
ssh [email protected] nprocErwartet (nach einer Minute):
4
setmem funktioniert mit --live sogar bei
laufender VM: Der Balloon-Treiber im Gast gibt dann Speicher an den Host
zurück oder holt ihn wieder, höchstens bis maxmem.
Fahre erste mit virsh shutdown erste
herunter, lösche sie aber nicht. In Tag 5 räumst du sie ab.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Session nur für Desktops:
qemu:///sessionist für Entwickler-Laptops gedacht. Server-VMs laufen inqemu:///system, weil nur dort VMs beim Booten des Hosts starten und libvirt-Netze und Bridges ohne Umwege gehen. - Gruppe libvirt ist fast root: Wer libvirt steuern
darf, kann eine VM mit
/des Hosts als Platte starten. Vergib die Gruppe wie sudo. - Definitionen sichern:
virsh dumpxmljeder Domain gehört ins Backup oder in Git. - Feste MACs: Plattformen wie Proxmox und OpenStack speichern die MAC jeder Karte, damit Gäste nach Umzügen und Neustarts ihr Netz behalten.