basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    СоветHomelabProxmox

    В каждую машину Proxmox — qemu-guest-agent, и галку Guest Agent у машины

    Гостевой агент — служба внутри машины, через которую Proxmox с ней общается: выключает её корректно, видит её адреса и замораживает файловую систему на секунду снимка, чтобы бэкап был целым. Без агента Proxmox выключает машину кнопкой ACPI, которую гость может проигнорировать, а бэкап делает как после внезапного отключения питания. Ставим пакет в госте и включаем опцию у машины — нужны оба.

    Агент работает по своему каналу — виртуальному последовательному порту 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»).