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 web1Erwartet:
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-123Erwartet:
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 --syncscheitert mitguest-set-time: this feature or command is not currently supported. Ubuntus Agent erlaubt das Stellen der Uhr nicht. Die Zeit hält im Gastsystemd-timesyncdaktuell.virsh domtime web1ohne--syncliest 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 -dErwartet:
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-statusmit derselben PID endet mitunable to execute QEMU agent command 'guest-exec-status': PID ld does not exist. Dasldist ein Fehler in der Meldung des Agenten. Gemeint ist die PID.Der Agent führt alles als root aus. Wer auf dem Host
virshbedienen darf, ist damit root in jedem Gast mit Agent.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Speicher im laufenden Betrieb
virsh dommemstat web1Erwartet (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 --liveErwartet:
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.txtvirtiofs braucht Arbeitsspeicher, den QEMU und virtiofsd
gemeinsam nutzen (shared memory). Das und die Freigabe selbst
ändern die Definition, also bei ausgeschalteter VM:
virsh shutdown web1virt-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 virtiofsdErwartet:
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@web1sudo 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
exitErwartet:
Hallo vom Host
Hallo vom Gast
teilen /mnt/teilen virtiofs defaults,nofail 0 0
Und auf dem Host:
ls -l /srv/teilenErwartet:
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 testmitcannot migrate domain: Migration disabled: vhost-user backend lacks VHOST_USER_PROTOCOL_F_LOG_SHMFD feature. Ein Snapshot mit RAM nutzt intern die Migrationstechnik, undvirtiofsdkann 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 notesErwartet:
<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.pngErwartet:
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 --hostnameErwartet: hostname : web1.
ssh ubuntu@web1 findmnt /mnt/teilenErwartet: /mnt/teilen teilen virtiofs rw,relatime.
ls /srv/teilenErwartet: 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 -dErwartet:
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-rpcsoderallow-rpcsin/etc/qemu/qemu-ga.confschränkst du ein, was der Agent darf.guest-execgehö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.