.. _Install_Windows_Integration_InstallingPortal:

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

.. note::

    Можно пропустить этот раздел, если на машину не планируется устанавливать :ref:`веб-портал <web-portal>`.

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

.. code-block:: console

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

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

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

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

.. code-block:: console

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

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

.. code-block:: console

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

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

.. code-block:: JSON

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

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

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

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

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

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

.. image:: ../img/IIS-AddApplicationPool-Menu.png
   :scale: 75
   :align: center
   :alt: IIS-AddApplicationPool-Menu
 
Затем нужно задать параметры пула:

* ``Name``: xde-integration-portal
* ``.NET CLR Version``: No Managed Code

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

.. image:: img/InstallingPortal-1.png
   :scale: 75
   :align: center
   :alt: InstallingPortal-1

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

.. image:: img/InstallingPortal-2.png
   :scale: 75
   :align: center
   :alt: InstallingPortal-2

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

.. image:: ../img/IIS-ApplicationPool-Identity.png
   :scale: 75
   :align: center
   :alt: IIS-ApplicationPool-Identity

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

.. image:: ../img/IIS-ApplicationPool-Custom-Account.png
   :scale: 75
   :align: center
   :alt: IIS-ApplicationPool-Custom-Account

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

.. image:: ../img/IIS-ApplicationPool-Custom-Account-Details.png
   :scale: 75
   :align: center
   :alt: IIS-ApplicationPool-Custom-Account-Details

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

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

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

.. image:: ../img/IIS-Add-Site.png
   :scale: 75
   :align: center
   :alt: IIS-Add-Site

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

* ``Site name``: xde-integration-portal
* ``Application pool``: xde-integration-portal
* ``Physical path``: C:\Program Files\TerraLink.xDEPro\Integration\Integration.REST
* ``Port``: 6111

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

.. image:: img/InstallingPortal-3.png
   :scale: 75
   :align: center
   :alt: InstallingPortal-3

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

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

.. image:: ../img/Firewall-Search.png
   :scale: 75
   :align: center
   :alt: Firewall-Search

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

.. image:: ../img/Firewall-New-Rule-Menu.png
   :scale: 75
   :align: center
   :alt: Firewall-New-Rule-Menu

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

.. image:: ../img/Firewall-Rule-Type.png
   :scale: 75
   :align: center
   :alt: Firewall-Rule-Type

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

.. image:: img/InstallingPortal-4.png
   :scale: 75
   :align: center
   :alt: InstallingPortal-4

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

.. image:: ../img/Firewall-Allow-Connection.png
   :scale: 75
   :align: center
   :alt: Firewall-Allow-Connection

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

.. image:: ../img/Firewall-Profiles.png
   :scale: 75
   :align: center
   :alt: Firewall-Profiles

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

.. image:: img/InstallingPortal-5.png
   :scale: 75
   :align: center
   :alt: InstallingPortal-5

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

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

.. code-block::

    http://192.168.11.128:6111

В ответ в браузере должна открыться страница авторизации :ref:`веб-портала <web-portal>`.