Перейти к содержанию

Space Agent PC

Space Agent PC (Агент физических машин) поддерживается на физических машинах под управлением ОС Astra Linux и Windows. Предназначен для организации взаимодействия диспетчера и клиентского устройства.

Внимание

Представленные далее версии файлов, пути их монтирования и IP-адреса приведены в качестве примера.


Space Agent PC для Astra Linux SE

Установка

Установка Space Agent PC производится согласно инструкции по установке Space Agent VDI.

Примечание

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

 sudo bash /media/cdrom/install.sh space-agent-pc
Во время установки необходимо указать:

  1. Адрес/адреса Space Dispatcher.

    Пример ввода нескольких адресов: 123.0.0.1,124.0.0.2,211.34.34.2.

  2. Порт Space Dispatcher.

    Указывается порт для подключения к Nats-серверу, запущенному на Space Disp. По умолчанию — 4222.

  3. Токен подключения.

    Токен генерируется автоматически и отображается в Space Disp в Web-интерфейсе Настройки - Общее - Ключи интеграции агента физических машин.


Установка с конфигурацией из файла

Для того чтобы во время установки из iso-образа не вводить адрес Space Disp, токен и порт, допускается размещение файла /root/agent-installer.conf с содержанием:

DISPATCHER_ADDRESSES=192.168.128.72,127.0.0.1,198.168.32.12
DISPATCHER_PORT=4222
TOKEN=IVNGbmpzZGtmdWv3

Запуск

Запуск Space Agent PC происходит сразу после установки.

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

sudo systemctl status space-agent-pc

Изменение настроек

Для повторной генерации ключа необходимо из /opt/space-agent-pc удалить старый ключ и вызвать скрипт agent-key-gen:

sudo ./agent-key-gen --disp-addr $DISP_ADDR --disp-port $DISP_PORT --token $TOKEN

где disp-addr — адрес диспетчера,
disp-port — порт диспетчера для подключения агента,
token — токен интеграции.

Адресов может быть несколько, в таком случае необходимо указывать их через запятую.

Затем необходимо перезапустить службу с выводом статуса:

sudo systemctl daemon-reload
sudo systemctl stop space-agent-pc.service

sudo systemctl start space-agent-pc.service
sudo systemctl status space-agent-pc.service

Обновить ключ можно также с помощью кнопки Обновить ключ в окне подробного просмотра физической машины в Web-интерфейсе Space Dispatcher. В открывшемся окне необходимо добавить актуальные адреса диспетчера.

Если обновление ключа происходит после новой установки диспетчера, также необходимо включить опцию Редактировать токен и ввести токен предыдущей установки.


Журнал

Журнал работы приложения сохраняется в файле /opt/space-agent-pc/journal.log и ротируется ежедневно с очисткой записей старше 7 дней.


Space Agent PC для Windows

Установка

Необходимо выполнить монтирование образа space-agent-vdi.

Затем установить Space Agent PC с помощью установочного файла, входящего в состав образа.

Во время установки необходимо указать:

  1. Место установки.

    По умолчанию: C:\Program Files (x86)\Space Agent PC.

  2. Адрес/адреса Space Dispatcher.

    Пример ввода нескольких адресов: 123.0.0.1,124.0.0.2,211.34.34.2.

  3. Порт Space Dispatcher.

    Указывается порт для подключения к Nats-серверу, запущенному на Space Disp. По умолчанию — 4222.

  4. Токен подключения.

    Токен генерируется автоматически и отображается в Space Disp в Web-интерфейсе Настройки - Общее - Ключи интеграции агента физических машин.


Запуск

Примечание

Команды рекомендуется выполнять из консоли Windows (не в PowerShell) и от имени администратора.

Запуск Space Agent PC происходит сразу после установки.

Если после установки Space Agent PC запуск агента не произошел, то необходимо запустить его при помощи команды:

sc start SpaceAgentPC

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

sc query SpaceAgentPC

Изменение настроек

Примечание

Команды рекомендуется выполнять из консоли Windows (не в PowerShell) и от имени администратора.

Для повторной генерации ключа необходимо из C:\Program Files (x86)\Space Agent PC (или из директории, в которую был установлен Space Agent PC) удалить старый ключ key.bin и вызвать скрипт agent-key-gen:

agent-key-gen.exe --disp-addr $DISP_ADDR --disp-port $DISP_PORT --token $TOKEN

где disp-addr — адрес диспетчера,
disp-port — порт диспетчера для подключения агента,
token — токен интеграции.

Адресов может быть несколько, в таком случае необходимо указывать их через запятую.

Затем необходимо перезапустить службу с выводом статуса:

sc stop SpaceAgentPC
sc start SpaceAgentPC
sc query SpaceAgentPC

Обновить ключ можно также с помощью кнопки Обновить ключ в окне подробного просмотра физической машины в Web-интерфейсе Space Dispatcher. В открывшемся окне необходимо добавить актуальные адреса диспетчера.

Если обновление ключа происходит после новой установки диспетчера, также необходимо включить опцию Редактировать токен и ввести токен предыдущей установки.


Журнал

Журнал работы Space Agent PC можно найти в журнале Windows:

  • Сочетанием клавиш Win + R открыть окно «Выполнить» в ОС Windows, затем ввести eventvwr.msc.
  • Перейти во вкладку Журналы Windows - Приложение.
  • В правой части окна нажать кнопку Фильтр текущего журнала и в поле Источники событий ввести SpaceAgentPC.