Установка QEMU-агента

Для корректной работы на ваш сервер должна быть установлена программа-демон QEMU Guest Agent. Она запускается внутри виртуальной машины и обеспечивает полноценную работу с сервером в панели управления. 

Эта инструкция описывает установку QEMU на машины Linux.

Для Windows сервис QEMU можно установить с помощью специального ISO-образа, который можно скачать здесь. Также с его помощью можно установить virtio-драйверы, необходимые для поддержки виртуализированных устройств. 

Если QEMU-агент отсутствует или отключен, в панели будут недоступны следующие действия:

• Создание бэкапа, в том числе автоматического
• Создание снапшота
• Добавление SSH-ключа
• Удаление SSH-ключа
• Сброс пароля root
• Клонирование сервера
• Создание образа сервера
• Открытие или закрытие доступа для поддержки
• Корректное отображение графиков дашборда

Если при создании сервера вы установили на него любое ПО из маркетплейса, QEMU-агент будет установлен автоматически. В остальных случаях вы можете установить его вручную по этой инструкции.

Хотя QEMU Guest Agent можно установить в BSD-системах (FreeBSD, OpenBSD, pfSense), он не поддерживает необходимые функции для управления виртуальной машиной и не будет работать корректно.

Проверка наличия QEMU-агента

Чтобы проверить, установлен ли агент QEMU на вашем сервере:

1. Подключитесь к серверу через веб-консоль в панели или по SSH.
2. Выполните команду:

    

      

    
    systemctl status qemu-guest-agent
  

Подобный вывод означает, что агент не установлен:

    

      

    
    Unit qemu-guest-agent.service could not be found.
  

А в данном случае агент есть, но отключен — нужно его перезапустить:

    

      

    
       Active: inactive (dead) since ...
  

Перезапуск qemu-guest-agent

Если вы уже устанавливали QEMU-агент, но описанный функционал панели недоступен, попробуйте перезапустить его — скорее всего, это решит проблему.

1. Подключитесь к серверу через веб-консоль в панели или по SSH.
2. Выполните команду:

    

      

    
    systemctl restart qemu-guest-agent.service
  

3. Проверьте, что все работает корректно, с помощью команды:

    

      

    
    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 и производных.

    

      

    
    sudo apt update
  

    

      

    
    sudo apt install qemu-guest-agent -y
  

Запустите агент:

    

      

    
    sudo systemctl start qemu-guest-agent
  

И добавьте его в автозапуск:

    

      

    
    sudo systemctl enable qemu-guest-agent