Для корректной работы на ваш сервер должна быть установлена программа-демон QEMU Guest Agent. Она запускается внутри виртуальной машины и обеспечивает полноценную работу с сервером в панели управления.
Эта инструкция описывает установку QEMU на машины Linux.
Для Windows сервис QEMU можно установить с помощью специального ISO-образа, который можно скачать здесь. Также с его помощью можно установить virtio-драйверы, необходимые для поддержки виртуализированных устройств.
Если QEMU-агент отсутствует или отключен, в панели будут недоступны следующие действия:
- Создание бэкапа, в том числе автоматического
- Создание снапшота
- Добавление SSH-ключа
- Удаление SSH-ключа
- Сброс пароля root
- Клонирование сервера
- Создание образа сервера
- Открытие или закрытие доступа для поддержки
- Корректное отображение графиков дашборда
Если при создании сервера вы установили на него любое ПО из маркетплейса, QEMU-агент будет установлен автоматически. В остальных случаях вы можете установить его вручную по этой инструкции.
Хотя QEMU Guest Agent можно установить в BSD-системах (FreeBSD, OpenBSD, pfSense), он не поддерживает необходимые функции для управления виртуальной машиной и не будет работать корректно.
Проверка наличия QEMU-агента
Чтобы проверить, установлен ли агент QEMU на вашем сервере:
- Подключитесь к серверу через веб-консоль в панели или по SSH.
- Выполните команду:
systemctl status qemu-guest-agent
Подобный вывод означает, что агент не установлен:
Unit qemu-guest-agent.service could not be found.
А в данном случае агент есть, но отключен — нужно его перезапустить:
Active: inactive (dead) since ...
Перезапуск qemu-guest-agent
Если вы уже устанавливали QEMU-агент, но описанный функционал панели недоступен, попробуйте перезапустить его — скорее всего, это решит проблему.
- Подключитесь к серверу через веб-консоль в панели или по SSH.
- Выполните команду:
systemctl restart qemu-guest-agent.service
- Проверьте, что все работает корректно, с помощью команды:
systemctl status qemu-guest-agent.service
Если все в порядке, вывод команды будет следующим:
qemu-guest-agent.service - QEMU Guest Agent
Loaded: loaded (/lib/systemd/system/qemu-guest-agent.service; static)
Active: active (running)
Установка qemu-guest-agent
Чтобы установить QEMU-агент, подключитесь к серверу по SSH и выполните в консоли приведенные ниже команды, выбрав вариант для вашей операционной системы.
Процесс установки зависит от используемого дистрибутива. Выберите подходящую вкладку:
- Debian-based — для Debian, Ubuntu, Astra Linux;
- RHEL-based — для CentOS, AlmaLinux, BitrixVM;
- Arch-based — для Arch Linux и производных.
Debian-based
Обновите репозитории:
sudo apt update
Установите QEMU Guest Agent:
sudo apt install qemu-guest-agent -y
RHEL-based
Обновите репозитории:
sudo yum update
Установите QEMU Guest Agent:
sudo yum install qemu-guest-agent -y
Arch-based
Обновите систему:
sudo pacman -Syu
Установите QEMU Guest Agent:
sudo pacman -S qemu-guest-agent
Запустите агент:
sudo systemctl start qemu-guest-agent
И добавьте его в автозапуск:
sudo systemctl enable qemu-guest-agent
Удивительно, что нет инструкции для freeBSD, а ведь она такая же простая как для linux.
Установить из репо агента
pkg install qemu-guest-agentАктивировать сервис для автозапуска
service qemu-guest-agent enableПри необходимости можно проверить запущен ли сервис
service qemu-guest-agent statusДобрый день!
Вы действительно можете установить агент для FreeBSD таким образом, но многие функции в панели управления останутся недоступными — в реализации агента для BSD не хватает функций, которые мы используем для управления ВМ. По этой причине мы не добавляем отдельную инструкцию по установке.
Мы добавили пометку об этом в статью. Спасибо за замечание!
Здравствуйте, в ssh консоли пишет: active (running). Но на сайте: QEMU-агент на сервере недоступен. Подскажите, пожалуйста, что нужно сделать в таком случае.
такая же проблема
Аналогично
Добрый день!
Создайте, пожалуйста, тикет в поддержку. Коллеги посмотрят, из-за чего возникает проблема, и помогут ее решить.
Если hostname поменял, все, не видит агента?
Смена hostname может повлиять на работу Qemu-агента. Пожалуйста, напишите в поддержку из своей панели — коллеги всё проверят и помогут настроить 👌
Для CentOS 6 нерабочая ссылка
Добрый день! Мы удалили устаревшую информацию из инструкции. CentOS 6 уже давно не поддерживается, для работы рекомендуем обновить систему до одной из актуальных версий.
Предложение правок к этой странице документации:
Спасибо! Внесли правки.