Skip to Content

Установка Оркестратора на Ред ОС 8 (non-root режим)

Это руководство описывает установку Оркестратора на Ред ОС 8 для работы служб в непривилегированном режиме (без прав пользователя root). Службы Оркестратора и nginx работают как пользовательские службы systemd (systemctl --user) от отдельной учётной записи.

Используемые имена

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

ЭлементЗначение
компьютерredos-orch — машина для работы служб Оркестратора
пользователь-администраторredos — обычная учётная запись Ред ОС (не root) с правом повышать привилегии через sudo; используется для начальной настройки ОС, каталогов и пользователей, установки RabbitMQ и PostgreSQL
пользователь-сервисprimo-rpa-service — для работы служб Оркестратора в непривилегированном режиме
каталоги/opt/Primo/PasswordEncryptor, /opt/Primo/MachineInfo, /opt/Primo/WebApi, /opt/Primo/RobotLogs, /opt/Primo/RDP2, /opt/Primo/Analytic, /opt/Primo/ArcSight, /opt/Primo/LogEventsWebhook, /opt/Primo/Notifications, /opt/Primo/NuGet2, /opt/Primo/States, /opt/Primo/Data (каталог для хранения данных), /opt/Primo/nginx
каталог дистрибутивов/home/redos/install

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

Важно! Команды от primo-rpa-service выполняйте в сеансе, открытом входом под этим пользователем (ssh primo-rpa-service@redos-orch). Не выполняйте их из оболочки root, через sudo или su: в первом случае файлы получат владельца root и службы не запустятся, во втором systemctl --user не найдёт пользовательский экземпляр systemd.

Содержание

Предварительные настройки

Отключите selinux здесь:

[redos@redos-orch ~]$ sudo nano /etc/selinux/config

Найдите строку:

SELINUX=enforcing

Замените ее на:

SELINUX=disabled

Перезагрузите:

[redos@redos-orch ~]$ sudo reboot

Обновите систему:

[redos@redos-orch ~]$ sudo dnf update

Подготовка учётных записей и каталогов

Создание учётной записи служб Оркестратора

Для работы служб Оркестратора создайте учётную запись:

[redos@redos-orch ~]$ sudo useradd -m -s /bin/bash primo-rpa-service

Задайте пароль учётной записи:

[redos@redos-orch ~]$ sudo passwd primo-rpa-service

Запуск служб без входа в систему

Разрешите пользовательским службам primo-rpa-service работать без входа пользователя в систему. Без этого службы запустятся только после входа primo-rpa-service и остановятся после выхода.

[redos@redos-orch ~]$ sudo loginctl enable-linger primo-rpa-service

Проверьте:

[redos@redos-orch ~]$ loginctl show-user primo-rpa-service --property=Linger # Linger=yes

Создание и настройка каталога служб

Для работы служб Оркестратора создайте и настройте следующие каталоги:

[redos@redos-orch ~]$ sudo mkdir -p /opt/Primo/Data [redos@redos-orch ~]$ sudo chown -R primo-rpa-service:primo-rpa-service /opt/Primo [redos@redos-orch ~]$ sudo chmod -R 750 /opt/Primo

Службы пишут файловые логи в /opt/Primo/<служба>/Logs, а данные — в подкаталоги /opt/Primo/Data, поэтому владельцем /opt/Primo должен быть primo-rpa-service.

Каталог дистрибутивов

Поместите архивы комплекта поставки в каталог /home/redos/install, а файлы nginx из комплекта поставки — в /home/redos/install/nginx (см. раздел «Установка Nginx»).

Домашний каталог redos по умолчанию закрыт для других пользователей. Дайте primo-rpa-service право читать каталог дистрибутивов:

[redos@redos-orch ~]$ mkdir -p ~/install/nginx [redos@redos-orch ~]$ setfacl -m u:primo-rpa-service:x /home/redos [redos@redos-orch ~]$ setfacl -R -m u:primo-rpa-service:rX /home/redos/install

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

Настройка журналов

Поскольку в непривилегированном режиме службы запускаются от обычного пользователя (без прав root), такому пользователю нужно явно разрешить читать системные журналы Оркестратора. Для этого выполните:

[redos@redos-orch ~]$ sudo install -m 2755 -g systemd-journal -o root -d /var/log/journal/ [redos@redos-orch ~]$ sudo systemctl restart systemd-journald

Подготовка RabbitMQ и PostgreSQL

RabbitMQ и PostgreSQL работают как системные службы и устанавливаются от redos через sudo одинаково для root- и non-root-установки. Выполните разделы «Установка RabbitMQ Server» и «Установка PostgreSQL 15» руководства по установке Оркестратора на Ред ОС 8

Перед продолжением убедитесь, что:

  • создан пользователь RabbitMQ — его имя и пароль, зашифрованный утилитой PasswordEncryptor, указываются в блоке RabbitMQ файлов appsettings.ProdLinux.json служб;
  • установлен пакет postgresql15-contrib — он содержит расширение citext, без которого не запустится служба NuGet2.

Установка и настройка инструмента PasswordEncryptor

Инструмент PasswordEncryptor шифрует пароли для указания в файлах конфигурации.

Установка

Распакуйте файлы инструмента PasswordEncryptor:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/PasswordEncryptor [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-passwordencryptor-<версия>-linux.zip -d /opt/Primo/PasswordEncryptor [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/PasswordEncryptor/Primo.Orchestrator.PasswordEncryptor

Обновление

[primo-rpa-service@redos-orch ~]$ rm /opt/Primo/PasswordEncryptor/* [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-passwordencryptor-<версия>-linux.zip -d /opt/Primo/PasswordEncryptor [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/PasswordEncryptor/Primo.Orchestrator.PasswordEncryptor

Установка Nginx

Подробное описание установки и настройки nginx без прав root приведено в статье Установка и настройка nginx без прав root.

nginx устанавливается из репозитория Ред ОС, но запускается пользовательской службой Оркестратора Primo.Orchestrator.Nginx от primo-rpa-service с конфигурационным файлом в /opt/Primo/nginx. От пакета нужны только исполняемый файл /usr/sbin/nginx и файл /etc/nginx/mime.types.

Установка пакета

Установите пакет:

[redos@redos-orch ~]$ sudo dnf install nginx

Отключите стандартную службу nginx — иначе она запустит второй nginx от root со своим конфигурационным файлом:

[redos@redos-orch ~]$ sudo systemctl disable --now nginx

Проверьте:

[redos@redos-orch ~]$ systemctl is-enabled nginx # disabled [redos@redos-orch ~]$ systemctl is-active nginx # inactive

Подготовка файлов nginx

Поместите в каталог /home/redos/install/nginx файлы из комплекта поставки той же версии, что и службы:

  • конфигурационный файл nginx.linux.conf;
  • файл службы Primo.Orchestrator.Nginx.user.service;
  • файлы сертификата cert1.crt и cert1.rsa.

Дайте primo-rpa-service право читать добавленные файлы:

[redos@redos-orch ~]$ setfacl -R -m u:primo-rpa-service:rX /home/redos/install

Копирование файлов nginx

Скопируйте конфигурационный файл и файлы сертификата:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/nginx/www [primo-rpa-service@redos-orch ~]$ cp /home/redos/install/nginx/nginx.linux.conf /opt/Primo/nginx/nginx.conf [primo-rpa-service@redos-orch ~]$ cp /home/redos/install/nginx/cert1.crt /opt/Primo/nginx/cert1.crt [primo-rpa-service@redos-orch ~]$ cp /home/redos/install/nginx/cert1.rsa /opt/Primo/nginx/cert1.rsa [primo-rpa-service@redos-orch ~]$ chmod 600 /opt/Primo/nginx/cert1.rsa # закрытый ключ — только владельцу

Установка службы

Установите nginx как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /home/redos/install/nginx/Primo.Orchestrator.Nginx.user.service ~/.config/systemd/user/Primo.Orchestrator.Nginx.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable --now Primo.Orchestrator.Nginx

Проверьте состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.Nginx # active (running)

Логи nginx пишутся в /opt/Primo/nginx/logs.

Управление службой

Перечитайте конфигурацию nginx (сначала выполняется проверка nginx -t; при ошибке в конфигурации nginx продолжит работать со старой):

[primo-rpa-service@redos-orch ~]$ systemctl --user reload Primo.Orchestrator.Nginx

Перезапустите службу nginx:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.Nginx

Остановите службу nginx:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.Nginx

Просмотрите системный журнал службы nginx:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.Nginx

Установка UI

UI раздается службой Primo.Orchestrator.Nginx из каталога /opt/Primo/nginx/www (создан на шаге установки Nginx).

Распакуйте файлы UI в этот каталог:

[primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-ui-<версия>.zip -d /opt/Primo/nginx/www

Проверьте, что index.html лежит в корне каталога:

[primo-rpa-service@redos-orch ~]$ ls /opt/Primo/nginx/www/index.html

Установка и настройка службы MachineInfo

Служба необходима для определения параметров оборудования для работы с лицензиями.

Установка

Распакуйте файлы службы MachineInfo:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/MachineInfo [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-machineinfo-<версия>-linux.zip -d /opt/Primo/MachineInfo [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/MachineInfo/Primo.Orchestrator.MachineInfo

Установите MachineInfo как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/MachineInfo/Primo.Orchestrator.MachineInfo.user.service ~/.config/systemd/user/Primo.Orchestrator.MachineInfo.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.MachineInfo

Настройка

Отредактируйте конфигурационный файл службы MachineInfo:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/MachineInfo/appsettings.ProdLinux.json

При необходимости укажите системный диск (имя диска можно посмотреть командой lsblk):

"Devices": { "HDD": "/dev/sda" }

Управление службой

Запустите службу MachineInfo и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.MachineInfo [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.MachineInfo

Перезапустите службу MachineInfo:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.MachineInfo

Остановите службу MachineInfo:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.MachineInfo

Просмотрите системный журнал службы MachineInfo:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.MachineInfo

Обновление

Важно! Ручное обновление службы MachineInfo производится только при остановленной службе.

Обновите файлы службы MachineInfo (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.MachineInfo [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-machineinfo-<версия>-linux.zip -d /opt/Primo/MachineInfo -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/MachineInfo/Primo.Orchestrator.MachineInfo [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.MachineInfo

Установка и настройка службы WebApi

WebApi — основная служба Оркестратора, отвечающая за согласованную работу всех компонентов и системы.

Установка

Распакуйте файлы службы WebApi:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/WebApi [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-webapi-<версия>-linux.zip -d /opt/Primo/WebApi [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/WebApi/Primo.Orchestrator.WebApi

Установите WebApi как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/WebApi/Primo.Orchestrator.WebApi.user.service ~/.config/systemd/user/Primo.Orchestrator.WebApi.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.WebApi

Для работы почтового сервера Exchange в Linux выполните следующую команду (если планируется использовать подключение для работы триггера, то нужно установить пакет gssntlmssp):

[redos@redos-orch ~]$ sudo dnf install gssntlmssp

Настройка

Отредактируйте конфигурационный файл службы WebApi:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/WebApi/appsettings.ProdLinux.json

В блоке ConnectionStrings заполните необходимые данные: HOST, USER ID, PASSWORD (пароль должен быть зашифрован утилитой PasswordEncryptor):

"ConnectionStrings": { "DefaultConnection": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=20;DATABASE=ltools;HOST=127.0.0.1;USER ID=postgres;SearchPath=public;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==", "IdentityConnection": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=20;DATABASE=ltoolsidentity;HOST=127.0.0.1;USER ID=postgres;SearchPath=public;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==", "LicenseConnection": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=20;DATABASE=ltoolslicense;HOST=127.0.0.1;USER ID=postgres;SearchPath=public;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==", "ProcessRepositoryConnection": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=120;DATABASE=ltoolsltwrepo;HOST=127.0.0.1;USER ID=postgres;SearchPath=public;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==" }

В блоке RobotDeployment укажите IP или FQDN сервера в OrchBaseUrl и RobotLogsBaseUrl:

"RobotDeployment": { "OrchBaseUrl": "https://redos-orch:44392", "RobotLogsBaseUrl": "https://redos-orch:44392", "SslCertPassword": "JLWIyl1xZNDVVx8tcVllOg==", "TimeOutInMinutes": 2, "OrchPassword": "JLWIyl1xZNDVVx8tcVllOg==" }

В блоке RabbitMQ заполните необходимые данные: Host, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor):

"RabbitMQ": { "Host": "127.0.0.1", "UserName": "admin", "Password": "JLWIyl1xZNDVVx8tcVllOg==", }

Проверьте пути для хранения данных (по умолчанию указаны подкаталоги /opt/Primo/Data).

Путь для хранения дистрибутива робота:

"RobotDistrUpload": { "PrefixFolder": "distr", "RobotDistrFileName": "LTools.Robot.zip", "TargetFilePath": "/opt/Primo/Data/RobotDistrs", "RobotExeFileName": "Primo.Robot.exe" },

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

"LogsDump": { "MaxPageCount": 100, "PageSize": 20000, "Path": "/opt/Primo/Data/LogDump", "ArchPath": "/opt/Primo/Data/LogArchs" },

Путь для хранения архивов проектов по умолчанию:

"RpaProjectArchiveUpload": { "TargetFilePath": "/opt/Primo/Data/RpaProjects" },

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

"AgentDistrUpload": { "TargetFilePath": "/opt/Primo/Data/AgentDistrs" }

Блок RDP. В RdpBaseUrl укажите IP-адрес или имя вашего сервера. Если используется только одна служба RDP2, в параметре RdpBaseUrls удалите лишнее и оставьте пустые фигурные скобки:

"RdpBaseUrl": "https://redos-orch:44392/rdpstream", "RdpBaseUrls": {}

Управление службой

Запустите службу WebApi и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.WebApi [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.WebApi

Перезапустите службу WebApi:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.WebApi

Остановите службу WebApi:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.WebApi

Просмотрите системный журнал службы WebApi:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.WebApi

Обновление

Важно! Ручное обновление службы WebApi производится только при остановленной службе.

Обновите файлы службы WebApi (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.WebApi [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-webapi-<версия>-linux.zip -d /opt/Primo/WebApi -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/WebApi/Primo.Orchestrator.WebApi [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.WebApi

Установка и настройка службы RobotLogs

RobotLogs — служба приема логов от Роботов и от Оркестратора.

Установка

Распакуйте файлы службы RobotLogs:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/RobotLogs [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-robotlogs-<версия>-linux.zip -d /opt/Primo/RobotLogs [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/RobotLogs/Primo.Orchestrator.RobotLogs

Установите RobotLogs как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/RobotLogs/Primo.Orchestrator.RobotLogs.user.service ~/.config/systemd/user/Primo.Orchestrator.RobotLogs.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.RobotLogs

Настройка

Отредактируйте конфигурационный файл службы RobotLogs:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/RobotLogs/appsettings.ProdLinux.json

В блоке ConnectionStrings заполните необходимые данные: HOST, USER ID, PASSWORD (пароль должен быть зашифрован утилитой PasswordEncryptor):

"ConnectionStrings": { "LogsConnection": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=20;DATABASE=ltoolslogs;HOST=127.0.0.1;USER ID=postgres;SearchPath=public;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==" }

В блоке RabbitMQ заполните необходимые данные: Host, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor):

"RabbitMQ": { "Host": "127.0.0.1", "UserName": "admin", "Password": "JLWIyl1xZNDVVx8tcVllOg==", }

Проверьте путь для хранения файлов скриншотов в блоке ScreenFileUpload (по умолчанию /opt/Primo/Data/ScreenFiles):

"ScreenFileUpload": { "MaxBatch": 0, "MaxBatchSended": 10, "ScreenFilePath": "/opt/Primo/Data/ScreenFiles", "CreateZipThreadSleep": 2000, "CountForDirectlyRequest": 1, "GetZipThreadSleep": 2000, "GetZipNonSeparationFactor": 2, "AgentTimeOut": 1, "ThumbFactor": 4 }

Управление службой

Запустите службу RobotLogs и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.RobotLogs [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.RobotLogs

Перезапустите службу RobotLogs:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.RobotLogs

Остановите службу RobotLogs:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.RobotLogs

Просмотрите системный журнал службы RobotLogs:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.RobotLogs

Обновление

Важно! Ручное обновление службы RobotLogs производится только при остановленной службе.

Обновите файлы службы RobotLogs (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.RobotLogs [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-robotlogs-<версия>-linux.zip -d /opt/Primo/RobotLogs -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/RobotLogs/Primo.Orchestrator.RobotLogs [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.RobotLogs

Установка и настройка службы RDP2

Служба для поддержки активных RDP-сессий для Windows-роботов. Также может использоваться для трансляции активных RDP-сессий в UI.

Установка

Распакуйте файлы службы RDP2:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/RDP2 [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-rdp2-<версия>-linux.zip -d /opt/Primo/RDP2 [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/RDP2/Primo.Orchestrator.RDP2

Установите RDP2 как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/RDP2/Primo.Orchestrator.RDP2.user.service ~/.config/systemd/user/Primo.Orchestrator.RDP2.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.RDP2

Настройка

Отредактируйте конфигурационный файл службы RDP2:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/RDP2/appsettings.ProdLinux.json

Внесите правки в следующие секции, пропишите IP-адрес или имя сервера, где установлена служба RDP2:

"EnabledOrigins": [ "https://redos-orch:44392" ], ... "Host": "redos-orch", //IP машины с сервисом RDP2. Если не задан, IP резолвится из http-запроса

Отредактируйте блок Orchestrator:

"Orchestrator": { "BaseUrl": "https://redos-orch:44392" }

Управление службой

Запустите службу RDP2 и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.RDP2 [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.RDP2

Перезапустите службу RDP2:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.RDP2

Остановите службу RDP2:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.RDP2

Просмотрите системный журнал службы RDP2:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.RDP2

Обновление

Важно! Ручное обновление службы RDP2 производится только при остановленной службе.

Обновите файлы службы RDP2 (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.RDP2 [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-rdp2-<версия>-linux.zip -d /opt/Primo/RDP2 -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/RDP2/Primo.Orchestrator.RDP2 [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.RDP2

Установка и настройка службы Analytic

Служба сбора и предоставления аналитики по событиям Оркестратора.

Установка

Распакуйте файлы службы Analytic:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/Analytic [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-analytic-<версия>-linux.zip -d /opt/Primo/Analytic [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/Analytic/Primo.Orchestrator.Analytic

Установите Analytic как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/Analytic/Primo.Orchestrator.Analytic.user.service ~/.config/systemd/user/Primo.Orchestrator.Analytic.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.Analytic

Настройка

Отредактируйте конфигурационный файл службы Analytic:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/Analytic/appsettings.ProdLinux.json

В блоке ConnectionStrings заполните необходимые данные: HOST, USER ID, PASSWORD (пароль должен быть зашифрован утилитой PasswordEncryptor):

"ConnectionStrings": { "AnalyticConnection": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=20;DATABASE=ltoolsanalytic;HOST=127.0.0.1;USER ID=postgres;SearchPath=public;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==" }

В блоке RabbitMQ заполните необходимые данные: Host, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor):

"RabbitMQ": { "Host": "127.0.0.1", "UserName": "admin", "Password": "JLWIyl1xZNDVVx8tcVllOg==", }

Отредактируйте блок Orchestrator (его необходимо создать в случае отсутствия):

"Orchestrator": { "BaseUrl": "https://redos-orch:44392" }

Управление службой

Запустите службу Analytic и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.Analytic [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.Analytic

Перезапустите службу Analytic:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.Analytic

Остановите службу Analytic:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.Analytic

Просмотрите системный журнал службы Analytic:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.Analytic

Обновление

Важно! Ручное обновление службы Analytic производится только при остановленной службе.

Обновите файлы службы Analytic (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.Analytic [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-analytic-<версия>-linux.zip -d /opt/Primo/Analytic -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/Analytic/Primo.Orchestrator.Analytic [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.Analytic

Установка и настройка службы ArcSight

ArcSight — служба экспорта событий аудита Оркестратора в формате CEF для SIEM-системы ArcSight.

Установка

Распакуйте файлы службы ArcSight:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/ArcSight [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-arcsight-<версия>-linux.zip -d /opt/Primo/ArcSight [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/ArcSight/Primo.Orchestrator.ArcSight

Установите ArcSight как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/ArcSight/Primo.Orchestrator.ArcSight.user.service ~/.config/systemd/user/Primo.Orchestrator.ArcSight.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.ArcSight

Настройка

Отредактируйте конфигурационный файл службы ArcSight:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/ArcSight/appsettings.ProdLinux.json

Управление службой

Запустите службу ArcSight и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.ArcSight [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.ArcSight

Перезапустите службу ArcSight:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.ArcSight

Остановите службу ArcSight:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.ArcSight

Просмотрите системный журнал службы ArcSight:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.ArcSight

Обновление

Важно! Ручное обновление службы ArcSight производится только при остановленной службе.

Обновите файлы службы ArcSight (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.ArcSight [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-arcsight-<версия>-linux.zip -d /opt/Primo/ArcSight -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/ArcSight/Primo.Orchestrator.ArcSight [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.ArcSight

Установка и настройка службы LogEventsWebhook

LogEventsWebhook — служба интеграции логов посредством веб-хуков.

Установка

Распакуйте файлы службы LogEventsWebhook:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/LogEventsWebhook [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-logeventswebhook-<версия>-linux.zip -d /opt/Primo/LogEventsWebhook [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/LogEventsWebhook/Primo.Orchestrator.LogEventsWebhook

Установите LogEventsWebhook как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/LogEventsWebhook/Primo.Orchestrator.LogEventsWebhook.user.service ~/.config/systemd/user/Primo.Orchestrator.LogEventsWebhook.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.LogEventsWebhook

Настройка

Отредактируйте конфигурационный файл службы LogEventsWebhook:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/LogEventsWebhook/appsettings.ProdLinux.json

В блоке RabbitMQ заполните необходимые данные: Host, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor):

"RabbitMQ": { "Host": "127.0.0.1", "UserName": "admin", "Password": "JLWIyl1xZNDVVx8tcVllOg==", }

Управление службой

Запустите службу LogEventsWebhook и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.LogEventsWebhook [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.LogEventsWebhook

Перезапустите службу LogEventsWebhook:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.LogEventsWebhook

Остановите службу LogEventsWebhook:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.LogEventsWebhook

Просмотрите системный журнал службы LogEventsWebhook:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.LogEventsWebhook

Обновление

Важно! Ручное обновление службы LogEventsWebhook производится только при остановленной службе.

Обновите файлы службы LogEventsWebhook (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.LogEventsWebhook [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-logeventswebhook-<версия>-linux.zip -d /opt/Primo/LogEventsWebhook -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/LogEventsWebhook/Primo.Orchestrator.LogEventsWebhook [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.LogEventsWebhook

Установка и настройка службы Notifications

Notifications — служба для рассылки уведомлений на email.

Установка

Распакуйте файлы службы Notifications:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/Notifications [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-notifications-<версия>-linux.zip -d /opt/Primo/Notifications [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/Notifications/Primo.Orchestrator.Notifications

Установите Notifications как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/Notifications/Primo.Orchestrator.Notifications.user.service ~/.config/systemd/user/Primo.Orchestrator.Notifications.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.Notifications

Настройка

Отредактируйте конфигурационный файл службы Notifications:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/Notifications/appsettings.ProdLinux.json

В блоке RabbitMQ заполните необходимые данные: Host, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor):

"RabbitMQ": { "Host": "127.0.0.1", "UserName": "admin", "Password": "JLWIyl1xZNDVVx8tcVllOg==", }

Управление службой

Запустите службу Notifications и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.Notifications [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.Notifications

Перезапустите службу Notifications:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.Notifications

Остановите службу Notifications:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.Notifications

Просмотрите системный журнал службы Notifications:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.Notifications

Обновление

Важно! Ручное обновление службы Notifications производится только при остановленной службе.

Обновите файлы службы Notifications (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.Notifications [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-notifications-<версия>-linux.zip -d /opt/Primo/Notifications -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/Notifications/Primo.Orchestrator.Notifications [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.Notifications

Установка и настройка службы NuGet2

NuGet2 — служба-сервер, используется для загрузки и управления nuget-пакетами.

Установка

Распакуйте файлы службы NuGet2:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/NuGet2 [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-nuget2-<версия>-linux.zip -d /opt/Primo/NuGet2 [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/NuGet2/BaGet

Установите NuGet2 как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/NuGet2/Primo.Orchestrator.NuGet.user.service ~/.config/systemd/user/Primo.Orchestrator.NuGet.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.NuGet

Настройка

Создайте БД ltoolsnuget и установите в ней расширение citext (команды выполняются от redos; пакет postgresql15-contrib должен быть установлен, см. «Установка RabbitMQ и PostgreSQL»):

[redos@redos-orch ~]$ sudo -i -u postgres psql -c 'CREATE DATABASE ltoolsnuget;' [redos@redos-orch ~]$ sudo -i -u postgres psql -d ltoolsnuget -c 'CREATE EXTENSION IF NOT EXISTS citext WITH SCHEMA public;'

Отредактируйте конфигурационный файл службы NuGet2:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/NuGet2/appsettings.ProdLinux.json

Отредактируйте блок “Database”. Заполните необходимые данные: Hostname, Port, DbName, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor); те же данные укажите в строке ConnectionString:

"Database": { "Type": "PostgreSql", //PostgreSql, SqlServer "ConnectionString": "PORT=5432;TIMEOUT=15;POOLING=True;MINPOOLSIZE=1;MAXPOOLSIZE=20;COMMANDTIMEOUT=20;DATABASE=ltoolsnuget;SearchPath=public;HOST=127.0.0.1;USER ID=postgres;PASSWORD=49EqQ30zfcQTWxEGYE/mSw==", "DbConnection": { "Hostname": "127.0.0.1", "Port": 5432, "Timeout": 15, "Pooling": true, "MinPoolSize": 1, "MaxPoolSize": 200, "CommandTimeOut": 20, "SearchPath": "public", "DbName": "ltoolsnuget", "UserName": "postgres", "Password": "49EqQ30zfcQTWxEGYE/mSw==" } },

Укажите необходимое место хранения пакетов:

"Storage": { "Type": "FileSystem" // Minio, FileSystem },

Если выбрана FileSystem, то пропишите путь (по умолчанию /opt/Primo/Data/Nuget):

"FileSystem": { "Path": "/opt/Primo/Data/Nuget" }

Управление службой

Запустите службу NuGet2 и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.NuGet [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.NuGet

Перезапустите службу NuGet2:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.NuGet

Остановите службу NuGet2:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.NuGet

Просмотрите системный журнал службы NuGet2:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.NuGet

Обновление

Важно! Ручное обновление службы NuGet2 производится только при остановленной службе.

Обновите файлы службы NuGet2 (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.NuGet [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-nuget2-<версия>-linux.zip -d /opt/Primo/NuGet2 -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/NuGet2/BaGet [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.NuGet

Установка и настройка службы States

States — служба вычисления системных состояний.

Установка

Распакуйте файлы службы States:

[primo-rpa-service@redos-orch ~]$ mkdir -p /opt/Primo/States [primo-rpa-service@redos-orch ~]$ unzip /home/redos/install/primo-rpa-orchestrator-states-<версия>-linux.zip -d /opt/Primo/States [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/States/Primo.Orchestrator.States

Установите States как службу и настройте автозапуск:

[primo-rpa-service@redos-orch ~]$ mkdir -p ~/.config/systemd/user [primo-rpa-service@redos-orch ~]$ cp /opt/Primo/States/Primo.Orchestrator.States.user.service ~/.config/systemd/user/Primo.Orchestrator.States.service [primo-rpa-service@redos-orch ~]$ systemctl --user daemon-reload [primo-rpa-service@redos-orch ~]$ systemctl --user enable Primo.Orchestrator.States

Настройка

Отредактируйте конфигурационный файл службы States:

[primo-rpa-service@redos-orch ~]$ nano /opt/Primo/States/appsettings.ProdLinux.json

В блоке RabbitMQ заполните необходимые данные: Host, UserName и Password (пароль должен быть зашифрован утилитой PasswordEncryptor):

"RabbitMQ": { "Host": "127.0.0.1", "UserName": "admin", "Password": "JLWIyl1xZNDVVx8tcVllOg==", }

Отредактируйте блок Orchestrator (его необходимо создать в случае отсутствия):

"Orchestrator": { "BaseUrl": "https://redos-orch:44392" }

Управление службой

Запустите службу States и проверьте ее состояние:

[primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.States [primo-rpa-service@redos-orch ~]$ systemctl --user status Primo.Orchestrator.States

Перезапустите службу States:

[primo-rpa-service@redos-orch ~]$ systemctl --user restart Primo.Orchestrator.States

Остановите службу States:

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.States

Просмотрите системный журнал службы States:

[primo-rpa-service@redos-orch ~]$ journalctl --user -u Primo.Orchestrator.States

Обновление

Важно! Ручное обновление службы States производится только при остановленной службе.

Обновите файлы службы States (файлы конфигурации не перезаписываются):

[primo-rpa-service@redos-orch ~]$ systemctl --user stop Primo.Orchestrator.States [primo-rpa-service@redos-orch ~]$ unzip -o -u /home/redos/install/primo-rpa-orchestrator-states-<версия>-linux.zip -d /opt/Primo/States -x appsettings.ProdLinux.json appsettings.json [primo-rpa-service@redos-orch ~]$ chmod a+x /opt/Primo/States/Primo.Orchestrator.States [primo-rpa-service@redos-orch ~]$ systemctl --user start Primo.Orchestrator.States

Настройка брандмауэра

Проверьте, работает ли брандмауэр:

[redos@redos-orch ~]$ sudo firewall-cmd --state

Если брандмауэр выключен (not running), шаг можно пропустить: все порты и так доступны. Для промышленной эксплуатации брандмауэр рекомендуется включить.

Если брандмауэр работает (running), откройте следующие порты:

[redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=44392/tcp --permanent # nginx: UI, API, подключение роботов [redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=5432/tcp --permanent # PostgreSQL: вместе с trust в pg_hba.conf открывает все базы всей сети без пароля [redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=25672/tcp --permanent # RabbitMQ, межузловой обмен: нужен только кластеру RabbitMQ, иначе лишняя точка входа [redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=5672/tcp --permanent # RabbitMQ AMQP: службам на этой машине хватает локального доступа, открытый порт пускает к брокеру всю сеть [redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=15672/tcp --permanent # веб-консоль RabbitMQ: открывает управление брокером всей сети [redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=56748/tcp --permanent # RobotLogs по HTTP без TLS в обход nginx, хотя роботы по умолчанию обращаются к нему через 44392 [redos@redos-orch ~]$ sudo firewall-cmd --zone=public --add-port=5051/tcp --permanent # MachineInfo: WebApi обращается к нему через localhost, снаружи порт не нужен

Перезагрузите для применения правил:

[redos@redos-orch ~]$ sudo firewall-cmd --reload