Агент работает по своему каналу — виртуальному последовательному порту virtio-serial, — а не по сети. Поэтому
нужны две части: порт со стороны Proxmox (опция у машины) и служба со стороны гостя (пакет).
Что даёт агент:
| Без агента | С агентом |
|---|---|
выключение — кнопка ACPI; гость без acpid или с зависшим процессом её не слышит |
выключение командой агенту, как poweroff изнутри |
| бэкап снимает диск посреди записи, как при внезапном отключении питания | на время снимка файловая система заморожена: fs-freeze, снимок, fs-thaw |
| адрес машины в интерфейсе не виден | Summary машины показывает её адреса; qm guest cmd 101 network-get-interfaces |
| команду в госте — только по SSH | qm guest exec 101 -- systemctl status nginx с хоста |
Как включить
В госте (Ubuntu и Debian):
sudo apt install -y qemu-guest-agent
sudo systemctl start qemu-guest-agent
У машины — Options › QEMU Guest Agent › Use QEMU Guest Agent, или:
qm set 101 --agent enabled=1
Если опцию включили у работающей машины, канал появится только после перезапуска её процесса: qm reboot 101
или выключить и включить из Proxmox — перезагрузка изнутри гостя не подойдёт. В шаблоне cloud-init агент и
опция включаются сразу, один раз для всех клонов («Шаблон VM с cloud-init»).
В Windows агент ставится с диска драйверов VirtIO (virtio-win.iso): программа qemu-ga-x86_64.msi в каталоге
guest-agent, вместе с драйверами VirtIO.
Если не работает
qm shutdown 101 падает: QEMU guest agent is not running
- Причина
- У машины включена опция агента, а в госте он не установлен или не запущен. Proxmox выключает через агента и ждёт ответа.
- Делаем
- Ставим и запускаем агент в госте. Если машина нужна выключенной сейчас — выключаем изнутри,
sudo poweroffпо SSH, илиqm stop 101, если в госте ничего не пишется.
В логе бэкапа: skipping guest-agent 'fs-freeze', agent configured but not running?
- Причина
- Опция агента включена, а агент в госте не отвечает: бэкап идёт без заморозки, база внутри может оказаться посреди записи.
- Делаем
systemctl status qemu-guest-agentв госте; после установки пакета на старом госте — перезапуск машины из Proxmox, чтобы появился канал агента.
Как проверить
qm guest cmd 101 ping # пустой вывод и код 0
qm guest cmd 101 get-osinfo # имя и версия системы гостя
qm guest cmd 101 fsfreeze-status # thawed — файловая система не заморожена
В логе следующего бэкапа машины — issuing guest-agent 'fs-freeze' command и fs-thaw следом
(«Бэкапы в Proxmox»).