Communityoplossing

QEMU Guest Agent op ZimaOS-VM's: wat ontbreekt

A user wanted QEMU Guest Agent support for ZimaOS virtualization and found that normal apt/yum installation paths were unavailable.

Kort samengevat: QEMU Guest Agent heeft zowel een hostkanaal als een guestdaemon nodig

Het inschakelen van “QEMU Guest Agent” in de interface van een hypervisor is slechts de helft van de configuratie. De VM-definitie moet een virtio-serieel kanaal met de naam org.qemu.guest_agent.0 beschikbaar maken, en het gastbesturingssysteem moet daadwerkelijk qemu-guest-agent uitvoeren. Als een van beide ontbreekt, kan de agent niet werken.

De handleiding voor de libvirt Guest Agent beschrijft beide vereisten. QEMU beschrijft hetzelfde host-/guestkanaalmodel in de architectuurnotities van de Guest Agent.

Als ZimaOS de guest op Proxmox is

De gebruikelijke Debian-instructie apt install qemu-guest-agent is niet rechtstreeks van toepassing op standaard ZimaOS. ZimaOS is een appliance-achtig Buildroot-systeem en geen Debian-/Ubuntu-host, dus apt en yum zijn geen algemene routes voor pakketbeheer. De handleiding voor pakketbeheer in ZimaOS legt deze grens uit.

Dat betekent dat het inschakelen van het selectievakje voor de Proxmox Guest Agent niet automatisch een daemon binnen ZimaOS installeert. De handleiding voor ZimaOS op Proxmox is een veiliger uitgangspunt voor VM-tests.

Als ZimaOS de hypervisor is waarop een andere VM draait

Een afzonderlijke test in april 2026 in de thread controleerde een ZVM-guest en vond in de guest geen /dev/virtio-ports en in de VM-XML geen kanaal org.qemu.guest_agent.0. Dat resultaat verklaart waarom het installeren van alleen de guestdaemon in die geteste build niet had geholpen.

# In een Linux-guest
ls -l /dev/virtio-ports/

# Op een libvirt-host
virsh dumpxml <vm-name> | grep -A4 -B2 guest_agent

Beschouw het resultaat uit april 2026 niet als een permanente productgarantie. Controleer het kanaal op de huidige build voordat je concludeert dat ZVM het nog steeds niet ondersteunt.

Wat je moet doen als je betrouwbare Guest-Agent-functies nodig hebt

Als je workflow afhankelijk is van het netjes afsluiten van guests, IP-rapportage, het bevriezen en hervatten van bestandssystemen of het orkestreren van back-ups, gebruik dan een guest-/hypervisorcombinatie waarvan beide onderdelen QEMU Guest Agent expliciet ondersteunen. Raadpleeg voor de huidige planning van virtualisatie met ZimaOS de vereisten voor Virtual Machine Manager en het overzicht van virtuele machines van Zima.