Table of Contents

QEMU Guest Agent для встановлень із власного ISO

Якщо ви встановлюєте операційну систему з власного ISO, усередині ОС також потрібно встановити QEMU Guest Agent. Це невеликий сервіс, через який платформа керування взаємодіє з вашим сервером.

Навіщо він потрібен?

Без QEMU Guest Agent кілька функцій клієнтського порталу будуть недоступні або працюватимуть ненадійно:

Функція Без QEMU Guest Agent
Показ приватної IP-адреси в клієнтському порталі Не відображається
Коректне вимкнення та перезавантаження Коректне вимкнення/перезавантаження працюють через ACPI; гостьовий агент додає керування через агента
Узгоджені резервні копії Файлова система може бути неналежно «заморожена»
Скидання пароля з клієнтського порталу Потребує гостьового агента
Керування SSH-ключами з клієнтського порталу Потребує гостьового агента

На серверах, створених із готових шаблонів ОС, QEMU Guest Agent уже встановлено. Встановлювати його вручну потрібно лише тоді, коли ви використали власний ISO.

Встановлення в Linux

Debian / Ubuntu:

apt update && apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

AlmaLinux / Rocky Linux / CentOS / RHEL:

dnf install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Щоб перевірити, що агент працює:

systemctl status qemu-guest-agent

Встановлення в Windows

Для встановлення у Windows потрібен ISO VirtIO Windows Guest Tools, який уже доступний у вашому VDC як попередньо завантажений ISO. Завантажувати його з інтернету не потрібно.

  1. Відкрийте сервер у клієнтському порталі та відкрийте картку ISO / CD-ROM на вкладці Overview сервера
  2. Оберіть “VirtIO Drivers for Windows (ISO)” у списку та натисніть Mount Only (перезавантаження не потрібне)
  3. У Windows відкрийте File Explorer і знайдіть новий привід CD-ROM із файлами virtio-win
  4. Запустіть virtio-win-gt-x64.msi — це встановить усі драйвери VirtIO та QEMU Guest Agent одразу
  5. Відкрийте Services (запустіть services.msc) і переконайтеся, що сервіс QEMU Guest Agent працює, а Startup Type встановлено на Automatic
  6. Після встановлення знову відкрийте картку ISO / CD-ROM , щоб відмонтувати ISO VirtIO, коли він більше не потрібен

Порада: якщо потрібен лише агент без інших драйверів, запустіть guest-agent\qemu-ga-x86_64.msi з того самого приводу CD-ROM.

Усунення проблем

Проблема Рішення
Приватна IP-адреса не відображається в клієнтському порталі Переконайтеся, що агент встановлено й запущено, потім перезавантажте сервер
Агент встановлено, але він не запускається (Linux) Виконайте: systemctl enable --now qemu-guest-agent
Агент встановлено, але він не запускається (Windows) Відкрийте services.msc, знайдіть QEMU Guest Agent, встановіть Startup Type на Automatic і натисніть Start
Не вдається знайти ISO VirtIO у Windows Відкрийте картку ISO / CD-ROM на вкладці Overview сервера, змонтуйте “VirtIO Drivers for Windows (ISO)”, потім знайдіть новий привід CD-ROM у File Explorer