.. _Install_Windows_Printforms_InstallingDashboard:

Установка Dashboard
###################

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

.. code-block:: console

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

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

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

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

.. code-block:: console

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

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

.. code-block:: console

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

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

.. code-block:: JSON

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

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

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

Для настройки доступа к Dashboard через 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-printforms-dashboard
* ``.NET CLR Version``: No Managed Code

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

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

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

.. image:: img/InstallingDashboard-2.png
   :scale: 75
   :align: center
   :alt: InstallingDashboard-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-printforms-dashboard
* ``Application pool``: xde-printforms-dashboard
* ``Physical path``: C:\Program Files\TerraLink.xDEPro\Printforms\Printforms.Dashboard
* ``Port``: 6133

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

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

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

Для того чтобы Dashboard был доступен снаружи, в настройки 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/InstallingDashboard-4.png
   :scale: 75
   :align: center
   :alt: InstallingDashboard-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/InstallingDashboard-5.png
   :scale: 75
   :align: center
   :alt: InstallingDashboard-5

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

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

.. code-block::

    http://192.168.11.128:6133

В ответ в браузере должна открыться страница авторизации :ref:`Dashboard <install-setup_setup_setup-printforms-dashboard_printforms-dashboard>`.