Установка Оркестратора на веб-сервер Nginx

Конфигурация:

Windows Server 2019
Nginx
PostgreSQL
RabbitMQ

Видеоинструкция

С видеоинструкцией по установке Оркестратора можно ознакомиться здесь .

Начальная подготовка

Подробнее в статье Предварительная настройка машины Оркестратора под Windows 2016 Server.

Переименуем сервер, дав ему простое и понятное название. Например, ORCHESTRATOR.
Раскомментируем в файле C:\Windows\System32\drivers\etc\hosts следующую строку:

alt

Разрешаем удаленные подключения к хосту. Заходим в Start Menu > Control Panel > System > Advanced System Settings > Remote и включаем настройку, как на рисунке ниже:

alt

Шаг 1. Подготовка и установка дистрибутивов

Подробнее в статье Предварительная настройка машины Оркестратора под Windows 2016 Server.

Создаем папку C:\Primo.
Создаем папку C:\Install и копируем в нее нужные дистрибутивы:

alt

Устанавливаем Google Chrome. Обновляем его до последней версии и делаем браузером по умолчанию.
Устанавливаем Notepad++. Все опции оставляем по умолчанию.
Устанавливаем PowerShell. При установке включаем все чекбоксы:

alt

Создаем папку docs на рабочем столе и копируем туда следующую документацию из комплекта поставки:

alt

Шаг 2. Настройка PostgreSQL

Подробнее в статье Установка PostgreSQL под Windows 2016 Server.

Устанавливаем PostgreSQL Server:

Распаковываем архив postgresql-13.4-1-windows.zip в папку C:\Install.
Кликаем по файлу C:\Install\postgresql-13.4-1-windows-x64.exe.
Выбираем Да в появившемся окне:

alt

В следующем окне выбираем Далее.

alt

Выбираем директорию (1), куда будет установлена программа. Оставляем все без изменения и жмем Далее (2).

alt

В окне выбора компонентов тоже все оставляем по умолчанию и нажимаем Далее.

alt

Прописываем путь C:\Primo\PostgreSQL\Data (1), где будут располагаться файлы базы данных Оркестратора и конфигурационные файлы, нажимаем Далее (2).

alt

Вводим пароль* (1) и его подтверждение (2) для суперпользователя БД (postgres), нажимаем Далее.

*В дальнейшем пароль можно будет изменить в PostgreSQL.

alt

В следующем окне не меняем настройки порта по умолчанию (5432) и нажимаем Далее.

alt

Из выпадающего меню (1) выбираем Русский, Россия (2) и нажимаем Далее (3).

alt

Перепроверяем введенные данные (1). В случае необходимости можно вернуться, кликнув Назад, и исправить параметры. Если все верно, выбираем Далее.

alt

В следующем окне нажимаем Далее.

alt

Дожидаемся завершения процесса установки.

alt

Stack Builder не понадобится, убираем галочку (1) и нажимаем Завершить (2):

alt

Заходим в PostgreSQL через pgAdmin (пользователь postgres/postgres). pgAdmin установится вместе с PostgreSQL и доступен через меню Пуск**.

**Требуется для определения параметров оборудования. Если для этого используется сервис MachineInfo, то не нужно.

15.1. Создаем пользователя, под которым будут работать компоненты Оркестратора, и необходимые БД:


CREATE ROLE orch_user WITH
  LOGIN
  NOSUPERUSER
  INHERIT
  NOCREATEDB
  NOCREATEROLE
  NOREPLICATION
  PASSWORD 'postgres';
GRANT pg_execute_server_program TO orch_user;

CREATE DATABASE ltools WITH OWNER orch_user;
CREATE DATABASE ltoolslogs WITH OWNER orch_user;
CREATE DATABASE ltoolsidentity WITH OWNER orch_user;
CREATE DATABASE ltoolslicense WITH OWNER orch_user;

15.2. В БД ltoolslicense выполняем скрипты из папки C:\Install\ltoolslicense:

get_cpu_id.sql;
get_hdd_id.sql;
get_host_name.sql.

🔸 ВАЖНО! При выполнении скриптов из postgresql-13/ltoolslicense нужно следить, чтобы случайно не внести изменения в текст скрипта. Недопустимо вносить даже незначимые, с точки зрения кода скрипта, пробелы и пустые строки. В том числе, если отредактировали скрипт в редакторе, который заменил визуально ненаблюдаемые символы конца строки (отличаются для Windows- и Linux-строк).

Настраиваем доступ к БД по сети (по умолчанию она доступна только локально по localhost):
- Открываем папку C:\Primo\PostgreSQL\Data.
- Вносим изменения в файл postgresql.conf:
```
listen_addresses = '*'
```
- Вносим изменения в файл pg_hba.conf:
```
local    all      all                  	trust
host     all      all     0.0.0.0/0  	trust
```
- Перезапускаем службу PostgreSQL.
- Проверяем статус работы службы:

✅ Установка и настройка сервера БД завершена.

Шаг 3. Установка RabbitMQ

Дополнительная информация содержится в статье Установка RabbitMQ под Windows 2016 Server.

Разрешаем localhost в файле C:\Windows\System32\drivers\etc\hosts.

alt

Разархивируем rabbitmq.zip в ту же папку C:\Install\rabbitmq.
Сначала устанавливаем Erlang (otp_win64_23.2.exe), все параметры оставляем по умолчанию.
Затем устанавливаем сам RabbitMQ (rabbitmq-server-3.8.11.exe), все параметры оставляем по умолчанию.
Производим первоначальное конфигурирование RabbitMQ:


> cd C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.11\sbin
> rabbitmq-plugins.bat enable rabbitmq_management
> rabbitmqctl.bat add_user "admin" "Qwe123!@#" 
> rabbitmqctl.bat set_user_tags admin administrator 
> rabbitmqctl.bat set_permissions -p / admin ".*" ".*" ".*" 
> rabbitmqctl.bat stop
> rabbitmqctl.bat start_app

Открываем веб-интерфейс управления RabbitMQ на http://localhost:15672 , убеждаемся, что он открывается:

alt

Заходим под пользователем admin/Qwe123!@#.

alt

Дальнейшее управление RabbitMQ можно осуществлять через этот веб-интерфейс.

Шаг 4. Установка и запуск служб

MachineInfo

Подробнее см. статью Установка MachineInfo как службы под Windows 2016 Server

В версии Windows 2016 Server среда исполнения ASP .NET Core предустановлена. Поэтому сразу устанавливаем MachineInfo.

Разархивируем C:\Install\MachineInfo.zip в папку C:\Primo\MachineInfo. Можно при помощи команды в PowerShell:


> $InstallPath = "C:\Install"
> Expand-Archive -LiteralPath "$InstallPath\MachineInfo.zip" -DestinationPath "C:\Primo\MachineInfo" -Force

Создаем системную переменную окружения. Для этого в PoweShell выполняем команду:


> [System.Environment]::SetEnvironmentVariable('ASPNETCORE_ENVIRONMENT', 'ProdWin', [System.EnvironmentVariableTarget]::Machine)

Регистрируем Primo.Orchestrator.MachineInfo.exe как службу Windows и сразу запускаем её. Она должна работать как локальная служба. Для этого в PowerShell последовательно выполняем команды:


> New-Service -Name Primo.Orchestrator.MachineInfo -BinaryPathName "C:\Primo\MachineInfo\Primo.Orchestrator.MachineInfo.exe" -Description "Primo.Orchestrator.MachineInfo" -DisplayName "Primo.Orchestrator.MachineInfo" -StartupType Automatic 
> $s = Get-Service "Primo.Orchestrator.MachineInfo"
> $s.Start()

После чего созданная служба Primo.Orchestrator.MachineInfo будет отображаться в списке всех служб как запущенная:

alt

Открываем порт 5051 на файерволе.
Если используется один сервер с MachineInfo, в конфигурационном файле службы WebApi прописываем ссылку на него.

Параметр Timeout (по умолчанию 4 сек.) – это время ответа, после которого сервис считается недоступным.

alt

Если используется кластер MachineInfo, или MachineInfo используется в гео-кластере, в конфигурационном файле службы WebApi прописываются ссылки на все узлы кластера:

alt

Порядок узлов имеет значение. В момент генерации запроса на лицензию должны быть доступны все узлы. Узлы нельзя скрывать за балансировщиком нагрузки (load balancer)!

Notifications

Подробнее см. статью Установка Notifications под Windows 2016 Server

Разархивируем C:\Install\Notifications.zip в папку C:\Primo\Notifications.
Редактируем конфигурацию Notifications в файле C:\Primo\Notifications\appsettings.ProdWin.json:
- Правим секцию Email, отвечающую за SMTP-сервер, с которого будет происходить рассылка.

alt

Проверяем, что значение системной переменной окружения DOTNET_ENVIRONMENT равно ProdWin. Для этого в PoweShell выполняем команду:


> [Environment]::GetEnvironmentVariable('DOTNET_ENVIRONMENT', 'Machine')

Если системная переменная окружения DOTNET_ENVIRONMENT не была создана, то создаем ее. Для этого в PowerShell выполняем команду:


> [System.Environment]::SetEnvironmentVariable('DOTNET_ENVIRONMENT', 'ProdWin', [System.EnvironmentVariableTarget]::Machine)

Регистрируем Primo.Orchestrator.Notifications.exe как службу Windows и сразу запускаем её. Она должна работать как сетевая служба. Для этого в PoweShell последовательно выполняем команды:


> New-Service -Name Primo.Orchestrator.Notifications -BinaryPathName "C:\Primo\Notifications\Primo.Orchestrator.Notifications.exe" -Description "Primo.Orchestrator.Notifications" -DisplayName "Primo.Orchestrator.Notifications" -StartupType Automatic 
> $s = Get-Service "Primo.Orchestrator.Notifications"
> $s.Start()

После чего созданная служба Primo.Orchestrator.Notifications будет отображаться в списке всех служб как запущенная.
Через интерфейс Оркестратора переходим в раздел Настройки > Пользователи. Редактируем для пользователей параметры рассылки - указываем e-mail и типы событий:

alt

RDP2

Подробнее в статье Установка RDP2 под Windows 2016 Server.

Разархивируем C:\Install\RDP2.zip в папкуC:\Primo\RDP2.
Редактируем конфигурацию RDP2 в файле C:\Primo\RDP2\appsettings.ProdWin.json:
- Меняем в секции Orchestrator адрес Оркестратора и учетку пользователя, можно использовать только системного пользователя rdpservice:
- Если поменялся пароль пользователя rdpservice – меняем. Пароль предварительно шифруем программой шифрования паролей.
- При необходимости устанавливаем значение AddressFilter для фильтрации по машине Агента либо оставляем поле пустым (будут использованы все Агенты системы).
Настраиваем путь до файла с логом и период ротации файла с логом (по умолчанию - день).
Проверяем, что значение системной переменной окружения DOTNET_ENVIRONMENT равно ProdWin. Для этого в PoweShell выполняем команду:


> [Environment]::GetEnvironmentVariable('DOTNET_ENVIRONMENT', 'Machine')

Создаем системную переменную окружения DOTNET_ENVIRONMENT, если она не создана ранее. Для этого в PowerShell выполняем команду:


> [System.Environment]::SetEnvironmentVariable('DOTNET_ENVIRONMENT', 'ProdWin', [System.EnvironmentVariableTarget]::Machine)

Регистрируем Primo.Orchestrator.RDP2.exe как службу Windows и сразу запускаем её. Она должна работать как локальная служба. Для этого в PowerShell последовательно выполняем команды:


> New-Service -Name Primo.Orchestrator.RDP2 -BinaryPathName "C:\Primo\RDP2\Primo.Orchestrator.RDP2.exe" -Description "Primo.Orchestrator.RDP2" -DisplayName "Primo.Orchestrator.RDP2" -StartupType Automatic

Запускаем службу. Служба должна работать под Local System account:

alt

Переходим на вкладку Восстановление (Recovery) и проверяем, что действия при сбое установлены:

alt

Проверяем через интерфейс Оркестратора, что RDP-сессия устанавливается корректно:

alt

Параметры сессии должны быть установлены следующим образом:

Authentication Level = Attemp Authentication
Negotiate Security Layer = True

alt

RobotLogs

Дополнительная информация - Установка RobotLogs как службы под Windows 2016 Server.

В версии Windows 2016 Server среда исполнения ASP .NET Core предустановлена. Поэтому сразу устанавливаем RobotLogs.

Сначала требуется установить RabbitMQ (см. «Руководство по установке RabbitMQ под Windows 2016 Server.docx»).
Разархивируем C:\Install\RobotLogs.zip в папку C:\Primo\RobotLogs. Можно при помощи команды в PowerShell:


> $InstallPath = "C:\Install"
> Expand-Archive -LiteralPath "$InstallPath\RobotLogs.zip" -DestinationPath "C:\Primo\RobotLogs " -Force

Создаем системную переменную окружения, если не создана ранее. Для этого в PoweShell выполняем команду:


> [System.Environment]::SetEnvironmentVariable('ASPNETCORE_ENVIRONMENT', 'ProdWin', [System.EnvironmentVariableTarget]::Machine)

Настраиваем конфигурационный файл:
- Настраиваем строки подключения в БД:
- Настраиваем UserName и Password сервера RabbitMQ, который используется для обработки логов со скринами рабочего стола:
- Настраиваем Host, UserName и Password сервера RabbitMQ, который используется для интеграции с Оркестратором:
- Открываем порт 5672 на файерволе сервера RabbitMQ, который используется для интеграции с Оркестратором.
- Сервер RabbitMQ, который используется для интеграции с Оркестратором, общий для очередей Primo.Orchestrator.RobotLogs и Primo.Orchestrator.WebApi. Поэтому требуется соблюдать соответствие названий очередей и обменников.
- Настраиваем URL Оркестратора. При необходимости, можно поменять пароль встроенной системной записи Orchestrator – одновременно через UI Оркестратора и в этой секции конфига:
- Настраиваем ScreenFilePath – путь до файлов со скринами рабочего стола, которые собираются с машины робота. Папка по этому пути должна быть создана заранее, и на неё должны быть настроены права на чтение и запись для всех.
- Настраиваем в соответствии с конфигурационным файлом WebApi список тенантов:
Регистрируем Primo.Orchestrator.RobotLogs.exe как службу Windows и сразу запускаем её. Она должна работать как локальная служба. Для этого в PowerShell последовательно выполняем команды:


> New-Service -Name Primo.Orchestrator.RobotLogs -BinaryPathName "C:\Primo\RobotLogs\Primo.Orchestrator.RobotLogs.exe" -Description "Primo.Orchestrator.RobotLogs" -DisplayName "Primo.Orchestrator.RobotLogs" -StartupType Automatic 
> $s = Get-Service "Primo.Orchestrator.RobotLogs"
> $s.Start()

После чего созданная служба Primo.Orchestrator.RobotLogs отобразится в списке всех служб как запущенная.
Открываем порт 56748 на файерволе, если служба RobotLogs не на одном сервере с Nginx для WebApi.
Проверяем, что в конфиге Nginx настроено проксирование на RobotLogs*:

*Или аналогично настроено в IIS для узла UI, если используется IIS.

alt

В конфигурационном файле Primo.Orchestrator.WebApi переключаем прием логов на сервис RobotLogs и перезапускаем Primo.Orchestrator.WebApi:

alt

Если запросы в RobotLogs проксируются через отдельный от WebApi эндпоинт, нужно указать в конфиг-файле Primo.Orchestrator.WebApi этот эндпоинт в RobotLogsBaseUrl:

alt

В настоящее время не поддерживается. Зарезервирован для дальнейшей оптимизации приема логов от роботов.

Тонкая настройка производительности приема логов настраивается в секции InputBufferRobotLogs:

alt

MaxQueueLength – максимальный размер входного буфера приема логов от робота. Чем выше, тем больший размер пачек логов робот без потерь может слать в Оркестратор.
MaxBatchSize – максимальный размер пачки за один раз сбрасываемый сервисом в БД ltoolslogs. Чем выше, тем меньше обращений в БД потребуется, но тем большее количество данных за один раз должно быть передано.
ThreadSleep – время (мс) опроса входного буфера.

States

Подробнее см. Установка States под Windows 2016 Server.

Разархивируем C:\Install\States.zip в папку C:\Primo\States.
Редактируем конфигурационный файл States - C:\Primo\States\appsettings.ProdWin.json:
- Находим секцию ConnectionStrings:
- И меняем значение HOST для всех строк подключения к БД на реальный IP серверов БД:
Если поменялся пользователь/пароль БД – их тоже меняем.
Проверяем, что значение системной переменной окружения DOTNET_ENVIRONMENT равно ProdWin. Для этого в PoweShell выполняем команду:
```
> [Environment]::GetEnvironmentVariable('DOTNET_ENVIRONMENT', 'Machine')
```
Создаем системную переменную окружения DOTNET_ENVIRONMENT, если она не создана ранее. Для этого в PowerShell выполняем команду:
```
> [System.Environment]::SetEnvironmentVariable('DOTNET_ENVIRONMENT', 'ProdWin', [System.EnvironmentVariableTarget]::Machine)
```
Регистрируем Primo.Orchestrator.States.exe как службу Windows и сразу запускаем. Она должна работать как сетевая служба. Для этого в PowerShell последовательно выполняем команды:
```
> New-Service -Name Primo.Orchestrator.States -BinaryPathName "C:\Primo\States\Primo.Orchestrator.States.exe" -Description "Primo.Orchestrator.States" -DisplayName "Primo.Orchestrator.States " -StartupType Automatic 
> $s = Get-Service "Primo.Orchestrator.States"
> $s.Start()
```

После чего созданная служба Primo.Orchestrator.States будет отображаться в списке всех служб как запущенная.

WebApi

Подробнее в статье статье Установка WebApi как службы под Windows 2016 Server.

В версии Windows 2016 Server среда исполнения ASP .NET Core предустановлена. Поэтому сразу устанавливаем WebApi.

Разархивируем C:\Install\WebApi.zip в папку C:\Primo\WebApi. Можно при помощи команды в PowerShell:
```
> Expand-Archive -LiteralPath "$InstallPath\WebApi.zip" -DestinationPath 'C:\Primo\WebApi' -Force
```
Редактируем конфигурацию WebApi в файле C:\Primo\WebApi\appsettings.ProdWin.json:
- Меняем адрес на реальный IP вашего сервера. См. nginx.config и «Руководство по установке Nginx под Windows 2016 Server.docx».
Создаем папку для публикации дистрибутивов робота, например, C:\tmp, и указываем её в конфиге appsettings.ProdWin.json:
Меняем в файле appsettings.ProdWin.json в секции ConnectionStrings значение HOST для всех строк подключения к БД на реальный IP серверов БД.

Для PostgreSQL это секция:

Где меняем значение атрибута:

Для MS SQL SERVER меняем значение здесь:
Если для работы лицензий используется сервис получения параметров оборудования, то настраиваем WebApi на работу с этим сервисом – вводим адрес сервиса:
Если поменялся пользователь/пароль БД – их тоже меняем.
Создаем системную переменную окружения. Для этого в PoweShell выполняем команду:
```
> [System.Environment]::SetEnvironmentVariable('ASPNETCORE_ENVIRONMENT', 'ProdWin', [System.EnvironmentVariableTarget]::Machine)
```
Регистрируем Primo.Orchestrator.WebApi.exe как службу Windows и сразу запускаем. Она должна работать как локальная служба. Для этого в PowerShell последовательно выполняем команды:
```
> New-Service -Name Primo.Orchestrator.WebApi -BinaryPathName "C:\Primo\WebApi\Primo.Orchestrator.WebApi.exe" -Description "Primo.Orchestrator.WebApi" -DisplayName "Primo.Orchestrator.WebApi" -StartupType Automatic 
> $s = Get-Service "Primo.Orchestrator.WebApi"
> $s.Start()
```
После чего созданная служба Primo.Orchestrator.WebApi будет отображаться в списке всех служб как запущенная:

alt

🔸 Служба может не запуститься. Наиболее вероятная причина – это неверный Connection string (пароль) в appsettings.ProdWin.json, или не развернута/не настроена какая-либо из четырех БД Оркестратора.

При обновлении службы WebApi может потребоваться дополнительная настройка для RabbitMQ. Для выполнения настройки необходимо перед стартом службы WebApi запустить скрипт из комплекта поставки:

deletequeues.bat – для RabbitMQ, запущенном на ОС Windows;
deletequeues.sh – для RabbitMQ, запущеном на ОС Linux.

Скрипты необходимо запустить на сервере, на котором запущен RabbitMQ.

Результат шага 4

После того, как все перечисленные службы установлены, они должны появиться в диспетчере служб Windows:

alt

Шаг 5. Установка Nginx как службы Windows

*Подробнее в статье Установка Nginx под Windows 2016 Server.

Чтобы установить Nginx в качестве службы, необходимо:

Разархивировать файл nginx-service.zip, который идет в комплекте поставки, в папку C:\Primo\nginx-1.21.1 (версия Nginx может измениться).

alt

Щелкнуть правой кнопкой мыши по пустому простанству и открыть PowerShell от имени администратора:

alt

Использовать команду установки:
```
.\nginx-service.exe install
```
После успешной установки службы запускать либо останавливать ее можно либо из Управление сервером > Службы:

alt

Либо из PowerShell (после установки службы окно PowerShell необходимо перезапустить) командами:


> net stop nginx
> net start nginx

alt

Установка UI на Nginx

Подробнее в статье Установка UI на Nginx под Windows 2016 Server.

Для варианта реализации Front на основе Nginx копируем содержимое папки UI из C:\install\UI.zip в C:\Primo\nginx-1.21.1\html.

После этих шагов перезагружаем сервер.

Шаг 6. Проверка работы служб и Оркестратора

Заходим в список служб и проверяем, что все ранее установленные службы запущены:

alt

Это службы:

nginx;
postgresql-x64-13;
Primo.Orchestrator.MachineInfo;
Primo.Orchestrator.Notifications;
Primo.Orchestrator.RDP2;
Primo.Orchestrator.RobotLogs;
Primo.Orchestrator.States;
Primo.Orchestrator.WebApi;
RabbitMQ.

Если какая-то из служб остановлена, то запускаем ее вручную.

Когда все службы запущены и работают, переходим по адресу: https://localhost:44392/

Логин: admin
Пароль: Qwe123!@#

✅ На этом установка и базовая настройка завершены.