Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 9: Gastsystem-Integration

Ziel: Den Gast über den Agenten abfragen und steuern, Speicher im laufenden Betrieb anpassen, ein Host-Verzeichnis per virtiofs teilen und an die grafische Konsole kommen. · Dauer: ca. 75 min · Voraussetzung: Tag 8

Briefing

  • virtio heißt: Der Gast weiß, dass er virtuell ist, und benutzt einfache paravirtuelle Geräte statt nachgebauter Hardware. Netz, Platte, Konsole, Zufall und Speicher-Balloon sind bei unseren VMs alle virtio.
  • Der QEMU Guest Agent ist ein Dienst im Gast. Er spricht über einen virtio-Kanal mit libvirt und kann Auskunft geben, Dateisysteme einfrieren, Passwörter setzen und Befehle ausführen. Netz braucht er nicht.
  • virtiofs hängt ein Verzeichnis des Hosts im Gast ein, ohne NFS und ohne Netz. Auf dem Host läuft dafür pro Freigabe ein virtiofsd.
 Host                                      Gast web1
 libvirt ── virtio-serial (Agent) ──────── qemu-guest-agent
 /srv/teilen ── virtiofsd ── vhost-user ── /mnt/teilen (Typ virtiofs)
 QEMU ── virtio-balloon ────────────────── gibt RAM zurück

Drill 1: Die virtio-Geräte

ssh ubuntu@web1 "lspci | grep -i virtio"

Erwartet:

01:00.0 Ethernet controller: Red Hat, Inc. Virtio 1.0 network device (rev 01)
03:00.0 Communication controller: Red Hat, Inc. Virtio 1.0 console (rev 01)
04:00.0 SCSI storage controller: Red Hat, Inc. Virtio 1.0 block device (rev 01)
05:00.0 Unclassified device [00ff]: Red Hat, Inc. Virtio 1.0 memory balloon (rev 01)
06:00.0 Unclassified device [00ff]: Red Hat, Inc. Virtio 1.0 RNG (rev 01)
07:00.0 SCSI storage controller: Red Hat, Inc. Virtio 1.0 block device (rev 01)
Gerät Aufgabe
network device Netzwerkkarte (enp1s0)
console der Kanal für den Gast-Agenten
block device vda und vdb
memory balloon Speicher zwischen Host und Gast verschieben
RNG Zufall aus /dev/urandom des Hosts, wichtig für SSH-Schlüssel beim ersten Boot

Alle stammen von „Red Hat, Inc.“: Die virtio-Geräte nutzen die PCI-Hersteller-ID, die heute Red Hat gehört.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Der Gast-Agent gibt Auskunft

web1 hat den Agenten seit Tag 4:

virsh guestinfo web1 --os --hostname --timezone
virsh domfsinfo web1

Erwartet:

os.id               : ubuntu
os.name             : Ubuntu
os.pretty-name      : Ubuntu 24.04.5 LTS
os.version          : 24.04.5 LTS (Noble Numbat)
os.version-id       : 24.04
os.machine          : x86_64
os.kernel-release   : 6.8.0-147-generic
os.kernel-version   : #147-Ubuntu SMP PREEMPT_DYNAMIC Thu Sep 24 11:33:16 UTC 2026
timezone.name       : UTC
timezone.offset     : 0
hostname            : web1

 Mountpoint   Name    Type   Target
-------------------------------------
 /            vda1    ext4   vda
 /boot        vda16   ext4   vda
 /boot/efi    vda15   vfat   vda

Kein SSH, kein Netz: Die Antworten kommen über den virtio-Kanal. Der Agent kann auch schreiben, zum Beispiel ein Passwort setzen:

virsh set-user-password web1 ubuntu lab-console-pw-123

Erwartet:

Password set successfully for ubuntu in web1

Damit kommst du über virsh console web1 wieder hinein, auch wenn SSH kaputt ist.

Ausprobiert: virsh domtime web1 --sync scheitert mit guest-set-time: this feature or command is not currently supported. Ubuntus Agent erlaubt das Stellen der Uhr nicht. Die Zeit hält im Gast systemd-timesyncd aktuell. virsh domtime web1 ohne --sync liest sie nur.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Befehle über den Agenten

Für alles andere gibt es das rohe Agent-Protokoll. guest-exec startet ein Programm im Gast und liefert eine Prozess-ID:

virsh qemu-agent-command web1 \
  '{"execute":"guest-exec","arguments":{"path":"/usr/bin/uptime","capture-output":true}}'

Erwartet (die PID weicht ab):

{"return":{"pid":826}}

Mit der PID holst du das Ergebnis ab:

virsh qemu-agent-command web1 '{"execute":"guest-exec-status","arguments":{"pid":826}}'

Erwartet:

{"return":{"exitcode":0,"out-data":"IDE2OjM5OjE4IHVwIDEgbWluLCAgMCB1c2VyLCAgbG9hZCBhdmVyYWdlOiAxLjA5LCAwLjU4LCAwLjIyCg==","exited":true}}

Die Ausgabe ist base64-kodiert:

echo IDE2OjM5OjE4IHVwIDEgbWluLCAgMCB1c2VyLCAgbG9hZCBhdmVyYWdlOiAxLjA5LCAwLjU4LCAwLjIyCg== | base64 -d

Erwartet:

 16:39:18 up 1 min,  0 user,  load average: 1.09, 0.58, 0.22

Achtung: Das Ergebnis lässt sich nur einmal abholen. Ein zweites guest-exec-status mit derselben PID endet mit unable to execute QEMU agent command 'guest-exec-status': PID ld does not exist. Das ld ist ein Fehler in der Meldung des Agenten. Gemeint ist die PID.

Der Agent führt alles als root aus. Wer auf dem Host virsh bedienen darf, ist damit root in jedem Gast mit Agent.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Speicher im laufenden Betrieb

virsh dommemstat web1

Erwartet (gekürzt):

actual 1048576
…
unused 854232
available 975288
usable 783832
…
rss 519252

actual ist, was der Gast bekommen hat, rss, was der QEMU-Prozess auf dem Host wirklich belegt. Der Balloon-Treiber im Gast kann Speicher zurückgeben:

ssh ubuntu@web1 "free -m | head -2"
virsh setmem web1 768M --live
sleep 5
ssh ubuntu@web1 "free -m | head -2"

Erwartet:

               total        used        free      shared  buff/cache   available
Mem:             961         291         625           1         186         669
               total        used        free      shared  buff/cache   available
Mem:             705         286         374           1         186         419

Der Gast sieht 256 MB weniger, ohne Neustart. Zurück geht es bis zur Obergrenze, mehr nicht:

virsh setmem web1 1024M --live
virsh setmem web1 2G --live

Erwartet:

error: invalid argument: cannot set memory higher than max memory

Die Obergrenze (setmaxmem) ändert sich nur bei ausgeschalteter VM, wie in der Challenge von Tag 3.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Ein Verzeichnis teilen mit virtiofs

sudo apt-get install -y virtiofsd
sudo mkdir -p /srv/teilen
echo "Hallo vom Host" | sudo tee /srv/teilen/gruss.txt

virtiofs braucht Arbeitsspeicher, den QEMU und virtiofsd gemeinsam nutzen (shared memory). Das und die Freigabe selbst ändern die Definition, also bei ausgeschalteter VM:

virsh shutdown web1

virt-xml aus dem Paket virtinst (Tag 3) ändert einzelne Teile der Domain-XML über Optionen wie bei virt-install.

Wenn virsh domstate web1 shut off zeigt:

virt-xml web1 --edit --memorybacking source.type=memfd,access.mode=shared
virt-xml web1 --add-device --filesystem \
  driver.type=virtiofs,source.dir=/srv/teilen,target.dir=teilen
virsh dumpxml web1 | grep -A3 -E "<memoryBacking|<filesystem"

Erwartet:

Domain 'web1' defined successfully.
Domain 'web1' defined successfully.
  <memoryBacking>
    <source type='memfd'/>
    <access mode='shared'/>
  </memoryBacking>
--
    <filesystem type='mount' accessmode='passthrough'>
      <driver type='virtiofs'/>
      <source dir='/srv/teilen'/>
      <target dir='teilen'/>

target dir ist kein Pfad, sondern ein Name, unter dem der Gast die Freigabe findet.

virsh start web1
ps -o user,args -C virtiofsd

Erwartet:

Domain 'web1' started

USER     COMMAND
root     /usr/libexec/virtiofsd --fd=44 -o source=/srv/teilen
root     /usr/libexec/virtiofsd --fd=44 -o source=/srv/teilen

Nach dem Booten im Gast:

ssh ubuntu@web1
sudo mkdir -p /mnt/teilen
sudo mount -t virtiofs teilen /mnt/teilen
cat /mnt/teilen/gruss.txt
echo "Hallo vom Gast" | sudo tee /mnt/teilen/antwort.txt
echo "teilen /mnt/teilen virtiofs defaults,nofail 0 0" | sudo tee -a /etc/fstab
exit

Erwartet:

Hallo vom Host
Hallo vom Gast
teilen /mnt/teilen virtiofs defaults,nofail 0 0

Und auf dem Host:

ls -l /srv/teilen

Erwartet:

total 8
-rw-r--r-- 1 root root 15 Nov 13 16:41 antwort.txt
-rw-r--r-- 1 root root 15 Nov 13 16:40 gruss.txt

Die Datei des Gasts gehört auf dem Host root. accessmode='passthrough' reicht die Benutzer-IDs unverändert durch. root im Gast ist root in /srv/teilen.

Ausprobiert: Mit virtiofs scheitert virsh snapshot-create-as web1 test mit cannot migrate domain: Migration disabled: vhost-user backend lacks VHOST_USER_PROTOCOL_F_LOG_SHMFD feature. Ein Snapshot mit RAM nutzt intern die Migrationstechnik, und virtiofsd kann seinen Zustand nicht mitgeben. Dasselbe gilt für Live-Migration in Tag 12.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Die grafische Konsole

web1 hat seit Tag 4 keine Grafik (--graphics none). notes und db haben den Standard von virt-install:

virsh dumpxml notes | grep -A3 "<graphics"
virsh domdisplay notes

Erwartet:

    <graphics type='spice' port='5901' autoport='yes' listen='127.0.0.1'>
      <listen type='address' address='127.0.0.1'/>
      <image compression='off'/>
    </graphics>
spice://127.0.0.1:5901

SPICE lauscht nur auf 127.0.0.1 von kvm1. Von außen kommt niemand direkt heran, und das ist gut so: Die Konsole hat kein Passwort. Ein Bild gibt es trotzdem, ohne Viewer:

virsh screenshot notes /tmp/notes.png
file /tmp/notes.png

Erwartet:

Screenshot saved to /tmp/notes.png, with type of image/png
/tmp/notes.png: PNG image data, 1280 x 800, 8-bit/color RGB, non-interlaced

Auf dem Bild steht notes login:, der Textbildschirm von tty1.

Für einen echten Viewer baust du von deinem Rechner aus einen SSH-Tunnel und öffnest remote-viewer aus dem Paket virt-viewer (Linux) oder eine SPICE-App:

ssh -L 5901:127.0.0.1:5901 [email protected]

Solange die Verbindung offen ist, zeigt remote-viewer spice://127.0.0.1:5901 auf deinem Rechner die Konsole von notes. In Tag 11 übernimmt virt-manager das Tunneln von selbst.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

virsh guestinfo web1 --hostname

Erwartet: hostname : web1.

ssh ubuntu@web1 findmnt /mnt/teilen

Erwartet: /mnt/teilen teilen virtiofs rw,relatime.

ls /srv/teilen

Erwartet: antwort.txt und gruss.txt.

Challenge

db hängt nur im Netz intern. Finde heraus, wie voll die Datenplatte von Postgres ist, ohne SSH.

Hinweis: guest-exec nimmt Argumente als Liste unter arg.

Lösung

virsh qemu-agent-command db \
  '{"execute":"guest-exec","arguments":{"path":"/usr/bin/df","arg":["-h","/var/lib/postgresql"],"capture-output":true}}'

Erwartet (die PID weicht ab):

{"return":{"pid":921}}
virsh qemu-agent-command db '{"execute":"guest-exec-status","arguments":{"pid":921}}'

Erwartet:

{"return":{"exitcode":0,"out-data":"RmlsZXN5c3RlbSAgICAgIFNpemUgIFVzZWQgQXZhaWwgVXNlJSBNb3VudGVkIG9uCi9kZXYvdmRiICAgICAgICA0LjlHICAgNDZNICA0LjZHICAgMSUgL3Zhci9saWIvcG9zdGdyZXNxbAo=","exited":true}}
echo RmlsZXN5c3RlbSAgICAgIFNpemUgIFVzZWQgQXZhaWwgVXNlJSBNb3VudGVkIG9uCi9kZXYvdmRiICAgICAgICA0LjlHICAgNDZNICA0LjZHICAgMSUgL3Zhci9saWIvcG9zdGdyZXNxbAo= | base64 -d

Erwartet:

Filesystem      Size  Used Avail Use% Mounted on
/dev/vdb        4.9G   46M  4.6G   1% /var/lib/postgresql

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Agent absichern: Mit block-rpcs oder allow-rpcs in /etc/qemu/qemu-ga.conf schränkst du ein, was der Agent darf. guest-exec gehört in Mandanten-Umgebungen gesperrt.
  • Windows-Gäste: Brauchen die virtio-win-Treiber (ISO von Fedora), sonst sehen sie weder virtio-Platten noch virtio-Netz. Der Agent ist dort mit dabei.
  • virtiofs mit Bedacht: Für Mandanten-VMs gehört eine ID-Abbildung (<idmap>) dazu, damit root im Gast nicht root auf dem Host ist. Und virtiofs verhindert Live-Migration.
  • Konsole im Betrieb: Proxmox und OpenStack bringen noVNC mit, eine Konsole im Browser, die sich über den Verwaltungsserver tunnelt.