Бесплатная миграция IT-инфраструктуры в облако
На главную
61c46507-12c7-4300-a301-bd8bc30c7c19
Инструкции для серверов

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

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

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

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

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

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

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

Проверка наличия 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
  1. Проверьте, что все работает корректно, с помощью команды:
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 и выполните в консоли приведенные ниже команды, выбрав вариант для вашей операционной системы.

Ubuntu 12.04, 14.04, 16.04

apt-get update; \
apt-get install wget -y; \
wget -O ./agent.deb $(wget -qO- https://packages.ubuntu.com/xenial-updates/amd64/qemu-guest-agent/download | grep -oP 'http://mirrors.kernel.org.*?\.deb'); \
dpkg -i ./agent.deb;

Ubuntu 18.04 и выше

apt update && apt install qemu-guest-agent -y;

CentOS 7, 8

yum update -y; \
yum install qemu-guest-agent -y;

Centos 9 Stream

yum install qemu-guest-agent

Debian 7

wget http://archive.debian.org/debian/pool/main/q/qemu/qemu-guest-agent_2.1+dfsg-12+deb8u5a~bpo70+1_amd64.deb
dpkg -i qemu-guest-agent_2.1+dfsg-12+deb8u5a~bpo70+1_amd64.deb

Debian 8 и выше

apt update; \
apt install qemu-guest-agent -y
Была ли статья полезна?
Ваша оценка очень важна
Комментарии 10
Alex
17.08.2024, 09:09

Здравствуйте, в ssh консоли пишет: active (running). Но на сайте: QEMU-агент на сервере недоступен. Подскажите, пожалуйста, что нужно сделать в таком случае.

Ярослав
20.08.2024, 13:38

такая же проблема

Дмитрий
Дмитрий
19.10.2024, 11:32

Аналогично

Timeweb Cloud
Timeweb Cloud
19.11.2024, 18:21

Добрый день!

Создайте, пожалуйста, тикет в поддержку. Коллеги посмотрят, из-за чего возникает проблема, и помогут ее решить.

AndreiAAn
AndreiAAn
15.04.2024, 15:07

Если hostname поменял, все, не видит агента?

Команда Timeweb Cloud
Команда Timeweb Cloud
16.04.2024, 06:32

Смена hostname может повлиять на работу Qemu-агента. Пожалуйста, напишите в поддержку из своей панели — коллеги всё проверят и помогут настроить 👌

banderaz79
banderaz79
26.03.2024, 07:16

Для CentOS 6 нерабочая ссылка

Команда Timeweb Cloud
Команда Timeweb Cloud
26.03.2024, 09:23

Добрый день! Мы удалили устаревшую информацию из инструкции. CentOS 6 уже давно не поддерживается, для работы рекомендуем обновить систему до одной из актуальных версий.

Alexander Mart
Alexander Mart
13.10.2023, 07:05

Предложение правок к этой странице документации:

diff
- Ubuntu 18.04
+ Ubuntu 18.04 и выше
Команда Timeweb Cloud
Команда Timeweb Cloud
13.10.2023, 09:50

Спасибо! Внесли правки.