Установка Dashboard

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

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

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

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

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

sudo nano /opt/TerraLink.xDEPro/Integration/Integration.Dashboard/wwwroot/app/config.ts

и задать строку подключения в переменной apiUrl, указав IP-адрес и порт для подключения к Integration API через Nginx:

export let apiUrl = "http://192.168.11.128:6101/";

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

Включение логирования

Для включения логирования в Dashboard требуется скопировать демонстрационный конфигурационный файл в конфигурационный файл, который будет использоваться Dashboard:

sudo cp /opt/TerraLink.xDEPro/Integration/Integration.Dashboard/appsettings.json.demo /opt/TerraLink.xDEPro/Integration/Integration.Dashboard/appsettings.json

Настройка доступа к Dashboard через Nginx

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

sudo nano /etc/nginx/sites-available/xde-integration-dashboard

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

server {
        # виртуальный сервер настраивается на порт по умолчанию для этого HTTP-приложения + 100
        listen        6110;

        # в примере доступ к этому HTTP-приложению возможен только по IP-адресу
        server_name   192.168.11.128;
        location / {
                # порт по умолчанию для этого HTTP-приложения - 6010
                proxy_pass         http://127.0.0.1:6010;
                proxy_http_version 1.1;
                proxy_set_header   Upgrade $http_upgrade;
                proxy_set_header   Connection keep-alive;
                proxy_set_header   Host $host:$server_port;
                proxy_cache_bypass $http_upgrade;
                proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header   X-Forwarded-Proto $scheme;
        }
}

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

Примечание

Для доступа по IP-адресу значение параметра server_name должно быть равно фактическому IP-адресу машины, на которую устанавливается Dashboard. Здесь указан пример IP-адреса.

Теперь нужно создать ссылку на конфигурационный файл сайта в папке /etc/nginx/sites-enabled/ и перезапустить Nginx:

sudo ln -s /etc/nginx/sites-available/xde-integration-dashboard /etc/nginx/sites-enabled/
sudo systemctl restart nginx

Предупреждение

Не используйте HTTP-подключение к Nginx в продуктивной среде. Это может привести к несанкционированному доступу к данным, в том числе к содержимому документов и паролям. Используйте HTTPS-подключение.

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

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

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

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

[Unit]
Description=TerraLink xDEPro Integration Dashboard

[Service]
WorkingDirectory=/opt/TerraLink.xDEPro/Integration/Integration.Dashboard
# доступ извне будет возможен только через Nginx
ExecStart=/opt/dotnet/dotnet /opt/TerraLink.xDEPro/Integration/Integration.Dashboard/TerraLink.xDEPro.Integration.Dashboard.dll --urls http://127.0.0.1:6010
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=xde-integration-dashboard
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-dashboard.service
sudo systemctl start xde-integration-dashboard

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

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

http://192.168.11.128:6110

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