Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 3: libvirt übernimmt

Ziel: libvirt installieren, die VM aus Tag 1 als libvirt-Domain beschreiben und mit virsh starten, 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.
  • virsh ist das Kommandozeilenwerkzeug dazu. Es spricht über eine Connection-URI mit libvirtd: qemu:///system für die VMs des Systems, qemu:///session fü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 --version

Erwartet:

10.0.0

Melde dich ab und wieder an, damit die Gruppe libvirt gilt. Dann:

virsh uri

Erwartet:

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 uri

Erwartet:

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 qemu

Erwartet (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 virbr0

Erwartet:

 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>
EOF

Fast 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 erste

Erwartet:

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 64055

Erwartet:

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 erste

Erwartet:

Domain 'erste' has been undefined

undefine löscht nur die Definition, nicht die Platte.

Ausprobiert: Ohne undefine scheitert ein zweites virsh define erste.xml mit domain '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 mit virsh 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 erste

Erwartet:

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 erste

destroy 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-cat liest 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 erste

Erwartet (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 default

Erwartet (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] lspci

Erwartet (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 -l

Erwartet (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 define oder virsh edit.

Und die echte QEMU-Befehlszeile steht im Log der Domain:

sudo head -12 /var/log/libvirt/qemu/erste.log

Erwartet (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 erste

Drü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 erste

Erwartet:

Domain 'erste' is being shutdown

Warte einige Sekunden, dann:

virsh domstate --reason erste

Erwartet:

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 uri

Erwartet: qemu:///system.

virsh list --all

Erwartet: erste mit dem Zustand shut off.

virsh domblklist erste

Erwartet: 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] nproc

Erwartet (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:///session ist für Entwickler-Laptops gedacht. Server-VMs laufen in qemu:///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 dumpxml jeder 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.