Гостевой агент

Гостевой агент — это специальная утилита, разработанная в нашей компании. Она автоматически устанавливается на виртуальные машины (VDS) в наших сетях и обеспечивает их взаимодействие с панелью управления.

Команды, выполняемые в панели управления, отправляются на VDS, где их обрабатывает гостевой агент. Например, это может быть добавление нового IP-адреса к серверу или сброс root-пароля. Гостевой агент выполнит нужные действия в системе и сообщит об этом в панель управления.

Также гостевой агент используется для сбора статистики с сервера, которая впоследствии будет отображаться в личном кабинете. При этом он никак не хранит и не обрабатывает пароли и прочие личные данные.

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

Как работает гостевой агент

Процесс запущенного на VDS гостевого агента можно увидеть под именем /usr/sbin/phoenix-ga. Фактически это обычная программа, запущенная в операционной системе на сервере, никаких особых полномочий у неё нет.

Как и в случае с другими программами, её выполнение может быть завершено операционной системой принудительно, например, в результате нехватки оперативной памяти. Кроме того, процесс можно завершить вручную через консоль сервера.

Если с гостевым агентом на сервере по тем или иным причинам не получается установить соединение, взаимодействие с панелью управления нарушается. В таком случае часть интерфейса станет недоступна, и появится всплывающая подсказка, говорящая о недоступности гостевого агента:

Это произойдёт и в том случае, если полностью удалить гостевой агент с сервера или искусственно ограничить его работу. Поэтому мы не рекомендуем выполнять данные действия, чтобы сохранить полноценную и стабильную работу VDS.

Перезапуск гостевого агента

Самый простой и действенный способ перезапустить процесс phoenix-ga — это перезагрузить виртуальную машину через панель управления. Гостевой агент по умолчанию настроен запускаться автоматически при старте системы.

Наша автоматика продолжит проверять состояние агента, и за 10-15 минут работа интерфейса должна восстановиться.

Если вы подключитесь к консоли сервера через SSH или VNC, то можно определить, запустился ли гостевой агент, при помощи следующей команды:

ps -C phoenix-ga >/dev/null && echo "OK" || echo "Error"

Если в результате её выполнения вы увидите сообщение “OK”, то гостевой агент на сервере запущен. Осталось подождать 10-15 минут для восстановления соединения с ним.

Появление надписи “Error” будет означать, что процесса с нужным именем в системе нет. В этом случае можно перейти к проверке настроек, описанных в следующем разделе.

Настройка запуска гостевого агента

Параметры запуска гостевого агента определяются установленной на VDS операционной системой и её версией. Стандартные настройки для вашей системы вы можете найти в списке ниже. Если они отсутствуют, самостоятельно пропишите их в соответствии с примером или обратитесь в нашу службу технической поддержки.

[Unit]
Description=Phoenix Guest Agent
After=systemd-udevd.service

[Service]
Restart=always
RestartSec=0.5
ExecStart=/usr/sbin/phoenix-ga
StandardOutput=null

[Install]
WantedBy=multi-user.target

# проверить состояние агента
systemctl status phoenix-ga

# ручной перезапуск процесса
systemctl restart phoenix-ga

#-- PGA begin
PGA:2345:respawn:/usr/sbin/phoenix-ga
#-- PGA end

start on runlevel [2345]
stop on shutdown
respawn
exec /usr/sbin/phoenix-ga

Поддержка гостевого агента

Утилита phoenix-ga постоянно обновляется нашими разработчиками и адаптируется для запуска и работы на самых разных серверах.

По любым вопросам функционирования гостевого агента вы можете обращаться в нашу службу технической поддержки, написав заявку из личного кабинета или на электронную почту info@netangels.ru.