Gemenskapslösning

QEMU-gästagent i ZimaOS-VM: Vad saknas

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

Sammanfattning: QEMU Guest Agent behöver både en värdkanal och en gästtjänst

Att aktivera ”QEMU Guest Agent” i ett hypervisorgränssnitt är bara halva konfigurationen. VM-definitionen måste exponera en virtio-serial-kanal med namnet org.qemu.guest_agent.0, och gästoperativsystemet måste faktiskt köra qemu-guest-agent. Om någon av sidorna saknas kan agenten inte fungera.

Guiden för libvirt Guest Agent dokumenterar båda kraven. QEMU beskriver samma modell med värd-/gästkanal i sina anteckningar om Guest Agent-arkitekturen.

Om ZimaOS är gästen i Proxmox

Den vanliga Debian-instruktionen apt install qemu-guest-agent kan inte direkt överföras till standardversionen av ZimaOS. ZimaOS är ett appliance-liknande Buildroot-system snarare än ett Debian-/Ubuntu-system, så apt och yum är inte allmänna pakethanteringsvägar. Guiden för ZimaOS pakethantering förklarar den begränsningen.

Det innebär att aktivering av kryssrutan för Proxmox Guest Agent inte automatiskt installerar en tjänst i ZimaOS. Guiden för ZimaOS i Proxmox är en säkrare utgångspunkt för VM-tester.

Om ZimaOS är hypervisorn som kör en annan VM

Ett separat test i tråden från april 2026 kontrollerade en ZVM-gäst och hittade varken /dev/virtio-ports i gästen eller någon org.qemu.guest_agent.0-kanal i VM:ens XML. Det resultatet förklarar varför en installation av gästtjänsten ensam inte skulle ha hjälpt i den testade versionen.

# Inuti en Linux-gäst
ls -l /dev/virtio-ports/

# På en libvirt-värd
virsh dumpxml <vm-name> | grep -A4 -B2 guest_agent

Betrakta inte resultatet från april 2026 som en permanent produktgaranti. Kontrollera kanalen i den aktuella versionen innan du drar slutsatsen att ZVM fortfarande saknar den.

Vad du bör göra när du behöver tillförlitliga Guest Agent-funktioner

Om ditt arbetsflöde är beroende av ordnad avstängning av gäster, IP-rapportering, frysning/upptining av filsystem eller samordning av säkerhetskopiering bör du använda en kombination av gäst och hypervisor där båda sidor uttryckligen stöder QEMU Guest Agent. För aktuell planering av virtualisering med ZimaOS, se kraven för Virtual Machine Manager och översikten över virtuella maskiner från Zima.