Установка веб-портала

Примечание

Можно пропустить этот раздел, если на машину не планируется устанавливать веб-портал.

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

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

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

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

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

Rename-Item -Path "$($env:ProgramFiles)\TerraLink.xDEPro\Integration\Integration.Portal\appsettings.json.demo" -NewName "appsettings.json"

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

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

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

{
    // ...
    "RestApiConnectionSettings": {
        "ApiConnectAddress": "http://192.168.11.128:6101"
    },
    // ...
}

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

Настройка доступа к веб-порталу через IIS

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

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

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

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

• Name: xde-integration-portal

• .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-portal

• Application pool: xde-integration-portal

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

• Port: 6111

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

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

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

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

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

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

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

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

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

Проверка доступности веб-портала

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

http://192.168.11.128:6111

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