.. _Install_AstraLinux_Printforms_InstallingDashboard:

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

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

.. code-block:: console

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

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

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

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

.. code-block:: console

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

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

.. code-block:: console

    sudo nano /opt/TerraLink.xDEPro/Printforms/Printforms.Dashboard/appsettings.json

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

.. code-block:: JSON

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

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

.. include:: ../../_Include/Printforms/Dashboard/SettingUpNginxAccess.rst
    
Автоматический запуск Dashboard
*******************************

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

.. code-block:: console

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

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

.. code-block:: ini

    [Unit]
    Description=TerraLink xDEPro Printforms Dashboard

    [Service]
    WorkingDirectory=/opt/TerraLink.xDEPro/Printforms/Printforms.Dashboard
    # доступ извне будет возможен только через Nginx
    ExecStart=/opt/dotnet/dotnet /opt/TerraLink.xDEPro/Printforms/Printforms.Dashboard/TerraLink.xDEPro.Printforms.Dashboard.Host.dll --urls http://127.0.0.1:6033
    Restart=always
    RestartSec=10
    KillSignal=SIGINT
    SyslogIdentifier=xde-printforms-dashboard
    User=xdeadmin
    Environment=ASPNETCORE_ENVIRONMENT=Production
    Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

    [Install]
    WantedBy=multi-user.target

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

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

.. code-block:: console

	sudo systemctl enable xde-printforms-dashboard.service
	sudo systemctl start xde-printforms-dashboard

.. include:: ../../_Include/Printforms/Dashboard/TestingDashboardAccess.rst