Перейти к основному содержимому

Отображение имени хоста через QEMU Guest Agent

Описание​

Описание функционала​

При установленном внутри гостевой ОС агенте qemu-guest-agent (GUEST_AGENT) в интерфейсе СГУ отображается фактическое имя хоста (hostname) виртуальной машины.

Назначение​

Функционал упрощает идентификацию виртуальных машин, особенно в следующих сценариях:

  • Массовое развёртывание ВМ из единого шаблона (клоны имеют одинаковые параметры, но разные hostname)
  • Отсутствие DNS-записей или рассинхронизация имён в домене и на уровне гипервизора
  • Быстрый поиск конкретной ВМ по внутреннему имени операционной системы без подключения к консоли

Требования​

  1. Развёрнутая платформа «Горизонт-ВС» и доступ к веб-интерфейсу СГУ.
  2. Учётная запись с правами на выполнение описанных операций.
  3. ВМ или шаблон ВМ, над которыми выполняется операция.

Пошаговая инструкция​

Требования​

Для корректного отображения имени хоста необходимо выполнение двух условий:

  1. В гостевой ОС установлен, запущен и работает сервис qemu-guest-agent
  2. В конфигурации ВМ (или шаблоне) активирована поддержка Guest Agent

Проверка работоспособности​

Linux:

systemctl status qemu-guest-agent
# или
ps aux | grep qemu-ga

Windows:

Get-Service QEMU-GA

После установки и запуска агента имя хоста автоматически появится в карточке ВМ в разделе Машины → ВМ → Информация.

Результат​

Настройки применены. Проверьте состояние объекта в СГУ или результатом проверки, описанной в инструкции.

Устранение неисправностей​

  • Проверьте состояние ВМ или другого объекта, корректность параметров и права учётной записи.
  • При повторной ошибке изучите журнал СГУ и сообщение об ошибке, не повторяя операцию без устранения её причины.

См. также​