Vaše VM Debian se spouští, její síť funguje, ale Proxmox stále zobrazuje „Guest Agent not running“ nebo nezobrazuje žádné informace. Zaškrtnutá možnost QEMU Guest Agent v rozhraní nestačí k navázání výměny s hostitelem.
QEMU Guest Agent nainstaluje démon do Debianu a vytvoří řídící kanál mezi VM a hostitelem. Zkontrolujete obě strany a poté izolujete poruchu konfigurace, služby nebo zařízení, aniž byste měnili síť VM.
K čemu slouží QEMU Guest Agent v Proxmoxu ?
VM může fungovat normálně bez agenta. Proxmox vidí virtuální stroj, ale nemá stejné úrovně informací o systému Debian běžícím uvnitř.
QEMU Guest Agent spouští qemu-ga v hostiteli. Démon komunikuje s hypervizorem přes zařízení virtio-serial, běžně vystavené v Debianu jako /dev/virtio-ports/org.qemu.guest_agent.0. Proxmox tak může žádat informace od VM, organizovat čisté vypnutí a koordinovat mrazení a rozmrazení souborového systému během určitých záloh nebo snímků.
Oficiální dokumentace Proxmox a QEMU popisuje tuto hostitelskou řetězovou, virtuální kanál a hostitelský démon. Agent nenahrazuje ani VirtIO síťový ovladač, ani DHCP, ani most, ani firewall.
Aktivace agenta na straně Proxmox před úpravou Debianu
Začněte zastavením VM, pokud plánujete upravit jeho hardwarovou konfiguraci. V rozhraní Proxmox otevřete VM Debian, přejděte do Možnosti, upravte QEMU Guest Agent a poté aktivujte možnost. Zkontrolujte také VMID zobrazené v rozhraní : bude sloužit pouze na hostiteli Proxmox.
Doporučuji zkontrolovat tuto možnost na straně Proxmox před instalací balíčku v Debianu. Takto oddělíte absenci virtuálního kanálu od pouze chybějící služby.
Ekvivalent příkazového řádku uvedený Proxmoxem je následující :
qm set VMID --agent 1Vyměňte VMID za číselný identifikátor vaší VM. Tento úkon aktivuje možnost na straně hostitele. Nespouští to službu Debian a neprokazuje přítomnost kanálu virtio-serial.
Pokud byla nastavení právě přidána a zařízení se v hostiteli nezobrazuje, proveďte řídicí vypnutí a opětovné spuštění VM. Nepředpokládejte, že horké připojení bude dostupné ve všech konfiguracích.
Nainstalujte a spusťte qemu-guest-agent v Debianu
Otevřete terminál v VM Debian. Aktualizace APT indexu zabrání práci se zastaralými metadaty :
sudo apt-get update
sudo apt-get install qemu-guest-agentPoté zkontrolujte jednotku systemd místo toho, abyste okamžitě pokračovali v restartování :
sudo systemctl status qemu-guest-agent --no-pagerMěli byste získat známou službu a stav active (running). Pokud je nainstalována, ale neaktivní, spusťte ji a aktivujte její spuštění s Debianem :
sudo systemctl start qemu-guest-agent
sudo systemctl enable qemu-guest-agentPo těchto akcích znovu zkontrolujte systemctl status. Chybová zpráva je užitečnější než pokus o opětovné spuštění. Instalace balíčku neovlivňuje síťovou kartu, most ani konfiguraci IP.
Zkontrolujte kanál virtio-serial ve VM
Aktivní služba může čekat na zařízení, které VM neprezentuje. Zkontrolujte cestu používanou QEMU Guest Agentem :
ls -l /dev/virtio-ports/org.qemu.guest_agent.0Soubor by měl být přítomen. Pokud chybí, opětovná instalace balíčku nic nevyřeší. Nejprve znovu zkontrolujte možnost QEMU Guest Agent v Proxmoxu a poté hardwarovou konfiguraci VM. Může být nutné provést řízené vypnutí a spuštění po úpravě.
Pokud cesta existuje, ale Proxmox stále neobdrží žádnou odpověď, přečtěte si poslední zprávy služby :
sudo journalctl -u qemu-guest-agent --no-pager -n 50Oficiální manpage Debianu pro qemu-ga také dokumentuje /etc/qemu/qemu-ga.conf a transport virtio-serial. Mějte tuto stopu pro chybu jednoznačně související s démonem nebo jeho kanálem, nikoli pro poruchu IP adresy.
Otestujte odpověď z hostitele Proxmox
Pozor: stav active (running) v Debianu potvrzuje službu, nikoli odpověď přijatou od hostitele. Chcete-li ověřit dostupnou syntaxi ve vaší verzi Proxmoxu, začněte na hostiteli tímto předletovým kontrolním testem :
qm help agentTato pomoc by měla potvrdit přesnou formu očekávanou vaší instalací. Poté vykonejte pouze formu qm agent, jak bylo zobrazeno tímto předletovým testem, s dotyčným VMID. Neposkytují zde žádné předpokládané podpříkazy : ty se mohou lišit podle verze nástroje a vymyšlený příkaz není test.
Očekávaným výsledkem je koherentní informační odpověď odpovídající VM zobrazené v Proxmoxu. Porovnejte ji se stavem agenta v rozhraní. Viditelná IP adresa může pomoci, ale nestačí k prokázání plné funkčnosti řídícího kanálu.
Opravit poruchu ve správné vrstvě
Když se příznaky podobají, tato tabulka zabrání opětovné instalaci Debianu v případě, že zařízení chybí na straně VM.
| Příznak | Pravděpodobná vrstva | Příkaz nebo kontrola | Minimální akce |
|---|---|---|---|
| Neaktivní možnost | Proxmox | Možnosti VM | Aktivovat QEMU Guest Agent, poté restartovat VM, pokud kanál neobjeví. |
| Neznámá jednotka | Debian | systemctl status qemu-guest-agent | Nainstalujte balíček pomocí APT, poté znovu zkontrolujte stav služby. |
| Chybná služba | Debian | systemctl status a journalctl | Přečtěte si první chybu před jakýmkoli novým spuštěním. |
| Chybějící zařízení | virtio-serial | ls -l /dev/virtio-ports/org.qemu.guest_agent.0 | Opravit možnost nebo virtuální hardware na straně Proxmoxu, poté provést cyklus vypnutí a spuštění. |
Pokud agent odpovídá z hostitele, ale VM stále nemá síť, zastavte diagnostiku QEMU Guest Agenta na tomto místě. Konektivita se týká mostu, virtuálního rozhraní nebo Debianu. Příspěvek Obnovit síť VM Proxmox, od mostu po hostitele pokrývá tento řetěz bez míchání obou problémů.
Pokud kontrola ukáže poruchu mostu na hostiteli, použijte spíše Vytvořit most Proxmox bez ztráty přístupu k serveru. Neměňte most, abyste opravili nedetekovaný agent : obě vrstvy komunikují, ale neplní stejné role.
Validace vypnutí a záloh bez nadměrného slibování
Platná odpověď z hostitele umožňuje poté zkontrolovat očekávané výhody. Proveďte řízené vypnutí hostitele z Proxmoxu a poté zkontrolujte úkol a protokoly hostitele. VM by se měla čistě vypnout, místo toho aby trpěla nuceným vypnutím.
Pro zálohu nebo snímek, který využívá mrazení souborového systému, také zkontrolujte zprávy úloh. Mrazení a rozmrazení zlepšují koherenci souborového systému. Nezaručují však aplikační soudržnost všech databází : databáze musí stále dodržovat svůj vlastní zálohovací protokol.
Zde jsou čtyři důkazy, které je třeba shromáždit před tím, než se považuje instalace za dokončenou :
- možnost QEMU Guest Agent je aktivní na straně Proxmox ;
- balíček a služba jsou přítomny v Debianu ;
- zařízení virtio-serial existuje na očekávané cestě ;
- hostitel dostává odpověď po předletovém testu
qm help agenta vhodném testu pro jeho verzi.
Řídící kanál je platný, když tyto čtyři kontroly shodují. Pokud odpovídá, nechte síť v klidu : není třeba agenta k opravě mostu.