Установка и настройка утилиты qemu-guest-agent для взаимодействия с гипервизором SpaceVM

Установка qemu-guest-agent из стандартных репозиториев

В Linux ВМ можно установить qemu-guest-agent из стандартных репозиториев. За дополнительной информацией необходимо обратиться к документации используемой ОС.

Для установки qemu-guest-agent выполнить команду:

для систем на базе Debian/Ubuntu (с apt-get):
```
apt-get install qemu-guest-agent
```
для систем на базе RedHat (с yum):
```
yum install qemu-guest-agent
```

Установка qemu-guest-agent с образа space-agent-vm

Также можно установить qemu-guest-agent с образа space-agent-vm. Для этого необходимо внутри образа space-agent-vm перейти в каталог по пути /linux/packages/qemu-guest-agent/ и установить нужную версию qemu-guest-agent:

dpkg -i qemu-guest-agent_5.2+dfsg-9_amd64.deb

Версия qemu-guest-agent

В команде используется версия пакета qemu-guest-agent_5.2+dfsg-9_amd64.deb в качестве примера. Необходимо выбрать нужную пользователю версию.

В зависимости от дистрибутива Space Agent VM утилита может не запуститься автоматически после установки. В таком случае рекомендуется запустить ее командой systemctl start qemu-guest-agent (для дистрибутивов, использующих systemd) или перезагрузить ВМ.

Взаимодействие гипервизора с qemu-guest-agent

qemu-guest-agent - утилита, которая принимает команды от хоста через virtio-канал с именем org.qemu.guest_agent.0 и исполняет их в контексте гостя. На стороне гипервизора канал заканчивается unix-сокетом, в который можно записать текстовые команды. Для каждой ВМ создается отдельный канал взаимодействия гипервизора со Space Agent VM, не зависящий от наличия сети у ВМ.

Пример

<channel type='unix'>                                                                                                                                                                                                                                     
  <source mode='bind' path='/var/lib/libvirt/qemu/channel/target/domain-89-d1134f72-2b4e-41c4-a/org.qemu.guest_agent.0'/>                                                                                                                                 
  <target type='virtio' name='org.qemu.guest_agent.0' state='disconnected'/>                                                                                                                                                                              
  <alias name='channel3'/>                                                                                                                                                                                                                                
  <address type='virtio-serial' controller='0' bus='0' port='4'/>                                                                                                                                                                                         
</channel>

В SpaceVM qemu-guest-agent используется для:

получения сетевых адресов и hostname;
корректного выключения ВМ вместо отправки ACPI-команд;
"замораживания" файловой системы перед созданием снимка, т.е. и при создании резервных копий ВМ;
ввода/вывода из AD;
установки hostname;
добавления SSH-ключей;
любых пользовательских команд и скриптов при необходимости.

Подробности работы qemu-guest-agent смотрите в QEMU Features/GuestAgent.

Настройка qemu-guest-agent

После установки qemu-guest-agent:

создать административную локальную учетную запись;
открыть службы Windows;
настроить запуск службы qemu-guest-agent не от учетной записи в локальной системе, а от ранее созданной учетной записи.

При блокировании пароля данной учетной записи служба Space Agent VM работать не будет.

Настройка службы

Необходимо для автоматического ввода ВМ в AD.

Внимание

Если групповые политики блокируют локальные учетные записи, то необходимо создать доменную учетную запись с правами Log on as a Service. Затем средствами GPO необходимо сконфигурировать службу qemu-guest-agent на запуск от этой учетной записи.

Проверка связи SpaceVM c компонентом qemu-guest-agent

Проверить, что связь с qemu_guest_agent есть, можно во вкладке Информация ВМ.

Статусы служб агента

Также в CLI сервера имеются команды работы со Space Agent VM: vm guest_info.

После установки qemu_guest_agent в разделе ВМ Информация о виртуальной машине будут отображаться следующие сведения о гостевой ОС:

версия Space Agent VM;
имя хоста;
IP-адрес;
id ОС;
kernel-release;
kernel version;
machine;
name;
pretty-name;
гостевые процессы ВМ;
информация о ФС.