Гостевой агент
Гостевой агент — это специальная утилита, разработанная в нашей компании. Она автоматически устанавливается на виртуальные машины (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 операционной системой и её версией. Стандартные настройки для вашей системы вы можете найти в списке ниже. Если они отсутствуют, самостоятельно пропишите их в соответствии с примером или обратитесь в нашу службу технической поддержки.
В большинстве ОС для запуска phoenix-ga используется система инициализации systemd. Конфигурационный файл находится по адресу /etc/systemd/system/phoenix-ga.service и содержит следующие настройки:
[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
Для управления гостевым агентом вручную можно использовать штатный функционал systemd, например:
# проверить состояние агента
systemctl status phoenix-ga
# ручной перезапуск процесса
systemctl restart phoenix-ga
В старых версиях Debian настройки запуска гостевого агента указаны в конфигурационном файле /etc/inittab:
#-- PGA begin
PGA:2345:respawn:/usr/sbin/phoenix-ga
#-- PGA end
Для этих ОС настройки запуска гостевого агента указаны в конфигурационном файле /etc/init/phoenix-ga.conf:
start on runlevel [2345]
stop on shutdown
respawn
exec /usr/sbin/phoenix-ga
Поддержка гостевого агента
Утилита phoenix-ga постоянно обновляется нашими разработчиками и адаптируется для запуска и работы на самых разных серверах.
По любым вопросам функционирования гостевого агента вы можете обращаться в нашу службу технической поддержки, написав заявку из личного кабинета или на электронную почту info@netangels.ru.
