Установка Integration API

Для установки Integration API требуется скопировать его файлы в целевую папку. Для этого нужно выполнить команду:

sudo cp -r ~/Загрузки/TerraLink.xDEPro/Integration.REST /opt/TerraLink.xDEPro/Integration/Integration.REST

Настройка подключения к базе данных

Теперь нужно настроить подключение Integration API к базе данных. Для этого требуется скопировать демонстрационный конфигурационный файл с шаблоном подключения к PostgreSQL в конфигурационный файл, который будет использоваться Integration API:

sudo cp /opt/TerraLink.xDEPro/Integration/Integration.REST/appsettings.PostgreSql.json.demo /opt/TerraLink.xDEPro/Integration/Integration.REST/appsettings.json

Далее нужно открыть конфигурационный файл в текстовом редакторе:

sudo nano /opt/TerraLink.xDEPro/Integration/Integration.REST/appsettings.json

найти поле ConnectionString и задать имя пользователя и пароль назначенной учетной записи:

{
    "ProviderName": "Npgsql",
    "ConnectionString": "User ID=xde;Password=1234aA;Host=localhost;Port=5432;Database=DOCFLOW_DB;MaxPoolSize=500"
}

Затем нужно сохранить файл (Ctrl+O) и выйти из редактора (Ctrl+X).

Примечание

Если планируется использовать PostgreSQL, установленный на другой машине, то в строке подключения нужно указать имя хоста (либо IP-адрес) и порт установленного экземпляра PostgreSQL.

Настройка подключения к Authentication API

Для работы Integration API понадобится подключение к Authentication API.

Для настройки подключения нужно открыть конфигурационный файл appsettings.json в текстовом редакторе и задать строку подключения в поле AuthenticationApiConnectAddress, указав имя или IP-адрес хоста и порт для подключения к Authentication API через Nginx:

"AuthenticationApiConnectAddress": "http://192.168.11.128:6133",

Автоматический запуск Integration API

Для автоматического запуска Integration API нужно в текстовом редакторе создать файл конфигурации сервиса:

sudo nano /etc/systemd/system/xde-integration-api.service

и скопировать в него содержимое:

[Unit]
Description=TerraLink xDEPro Integration API

[Service]
WorkingDirectory=/opt/TerraLink.xDEPro/Integration/Integration.REST
# доступ извне будет возможен только через Nginx
ExecStart=/opt/dotnet/dotnet /opt/TerraLink.xDEPro/Integration/Integration.REST/TerraLink.xDEPro.Integration.Rest.Host.dll --urls http://127.0.0.1:6001
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=xde-integration-api
User=xdeadmin
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

Затем нужно сохранить файл (Ctrl+O) и выйти из редактора (Ctrl+X).

Теперь нужно включить и запустить сервис:

sudo systemctl enable xde-integration-api.service
sudo systemctl start xde-integration-api

Проверка доступности Integration API

Для проверки доступности Integration API нужно открыть браузер на машине, отличной от той, на которую производится установка. В адресной строке браузера указать настроенный адрес и порт:

http://192.168.11.128:6101

В ответ в браузере должна открыться страница Swagger UI.