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

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 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

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

Для повторной генерации ключа необходимо:

  1. Перейти в каталог: 
    cd /opt/space-agent-pc

  2. Удалить старый ключ.

  3. Остановить работу Space Agent PC:

    sudo systemctl stop space-agent-pc

  4. Сгенерировать ключ агента, выполнив команду: 

    sudo ./space-agent --keygen --disp-addr $DISP_ADDR --token $TOKEN

    где $DISP_ADDR — IP-адрес Space Dispatcher, к которому выполняется подключение.
    $TOKEN — ключ интеграции агента физических машин. Ключ можно получить в Web-интерфейсе Space Disp в разделе Настройки - Общие.

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

  5. Запустить Space Agent PC: 

    sudo systemctl start space-agent-pc

Журнал

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

Space Agent PC для РЕД ОС

Установка

Внимание

Перед установкой Space Agent PC на РЕД ОС 8 необходимо убедиться, что отключён SELinux. Если SELinux включён, необходимо открыть конфигурацию SELinux:

sudo nano /etc/selinux/config

В конфигурации заменить SELINUX=enforcing на SELINUX=permissive.

SELINUXTYPE=targeted заменять не нужно.

Установка Space Agent PC производится по умолчанию при установке space-agent-vdi согласно инструкции по установке Space Agent VDI для РЕД ОС. Для установки пакета space-agent-pc отдельно необходимо выполнить действия:

  1. Произвести установку Space Agent PC: 

    sudo bash /mnt/install.sh space-agent-pc

  2. Перезагрузить систему.

  3. Перейти в каталог: 

    cd /opt/space-agent-pc

  4. Остановить работу Space Agent PC:

    sudo systemctl stop space-agent-pc

  5. Сгенерировать ключ агента, выполнив команду: 

    sudo ./space-agent --keygen --disp-addr $DISP_ADDR --token $TOKEN

    где $DISP_ADDR — IP-адрес Space Dispatcher, к которому выполняется подключение.
    $TOKEN — ключ интеграции агента физических машин. Ключ можно получить в Web-интерфейсе Space Disp в разделе Настройки - Общие.

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

  6. Запустить Space Agent PC: 

    sudo systemctl start space-agent-pc

Запуск

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

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

sudo systemctl status space-agent-pc

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

Для изменения настроек необходимо повторно сгенерировать ключ, выполнив шаги 3–6 из раздела по установке Space Agent PC для РЕД ОС.

Журнал

Журнал работы приложения сохраняется в файле /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 — IP-адрес Space Dispatcher, к которому выполняется подключение.
$DISP_PORT — порт Space Dispatcher для подключения агента.
$TOKEN — ключ интеграции агента физических машин. Ключ можно получить в Web-интерфейсе Space Dispatcher в разделе Настройки - Общие.

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

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

sc stop SpaceAgentPC
sc start SpaceAgentPC
sc query SpaceAgentPC

Журнал

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

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