Установка Dashboard

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

Copy-Item ".\TerraLink.xDEPro\Integration.Dashboard" -Destination "$($env:ProgramFiles)\TerraLink.xDEPro\Integration\Integration.Dashboard" -Recurse

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

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

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

notepad "$($env:ProgramFiles)\TerraLink.xDEPro\Integration\Integration.Dashboard\wwwroot\appsettings.json"

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

"ApiConnectAddress": "http://192.168.11.128:6101",

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

Примечание

Dashboard является SPA-приложением.

Файл appsettings.json загружается в браузер, поэтому имя или IP-адрес хоста должны быть внешними, чтобы Dashboard смог подключаться к Integration API.

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

Файл appsettings.json не должен содержать пароли, ключи доступа к API и т. д.

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

По умолчанию логирование в Dashboard включено и настроено на логирование в консоль браузера.

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

Для настройки доступа к Dashboard через IIS требуется открыть приложение IIS Manager.

Создание пула приложений

В IIS Manager выбрать элемент «Application Pools» и в его контекстном меню выбрать команду «Add Application Pool…»:

Затем нужно задать параметры пула:

• Name: xde-integration-dashboard

• .NET CLR Version: No Managed Code

Остальные параметры оставить без изменений и нажать кнопку OK:

Теперь нужно задать учетную запись для работы пула приложений. Для этого выбрать пул в списке и справа на панели «Actions» выбрать действие «Advanced Settings…»:

В окне «Advanced Settings» нужно найти настройку «Identity» и нажать кнопку ...:

В окне «Application Pool Identity» выбрать «Custom account» и нажать кнопку Set...:

В окне «Set Credentials» задать имя пользователя, от имени которого ведется установка Продукта, его пароль, и подтвердить пароль. После этого нажать кнопку OK:

Затем нажать кнопку OK в окне «Application Pool Identity» и в окне «Advanced Settings».

Создание сайта

В IIS Manager выбрать элемент «Sites» и в его контекстном меню выбрать команду «Add Website…»:

Затем нужно задать параметры сайта:

• Site name: xde-integration-dashboard

• Application pool: xde-integration-dashboard

• Physical path: C:Program FilesTerraLink.xDEProIntegrationIntegration.Dashboard

• Port: 6110

Остальные параметры оставить без изменений и нажать кнопку OK:

Добавление правила в настройки Firewall

Для того чтобы Dashboard был доступен снаружи, в настройки Firewall нужно добавить правило, открывающее порт созданного сайта. Для этого в строке поиска нужно набрать текст «advanced security» и в результатах поиска выбрать приложение «Windows Defender Firewall with Advanced Security»:

В окне приложения выбрать элемент «Inbound Rules» и в его контекстном меню выбрать команду «New Rule…»:

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

Далее нужно указать значение порта для созданного сайта и нажать кнопку Next:

Далее нужно разрешить подключение и нажать кнопку Next:

Далее выбрать типы сетей, из которых разрешено подключение (по умолчанию подключение разрешено из всех), и нажать кнопку Next:

Далее нужно задать имя для правила и нажать кнопку Finish:

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

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

http://192.168.11.128:6110

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