.. _Install_AstraLinux_DocumentsGeneration_InstallingApi:

Установка Documents Generation API
##################################

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

.. code-block:: console

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

Настройка подключения к базе данных
***********************************

Теперь нужно настроить подключение Documents Generation API к базе данных.
Для этого требуется скопировать демонстрационный конфигурационный файл с шаблоном подключения к PostgreSQL в конфигурационный файл,
который будет использоваться Documents Generation API:

.. code-block:: console

    sudo cp /opt/TerraLink.xDEPro/DocumentsGeneration/DocumentsGeneration.REST/appsettings.PostgreSql.DocumentsGeneration.json.demo /opt/TerraLink.xDEPro/DocumentsGeneration/DocumentsGeneration.REST/appsettings.json

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

.. code-block:: console

    sudo nano /opt/TerraLink.xDEPro/DocumentsGeneration/DocumentsGeneration.REST/appsettings.json

найти поле ``ConnectionString`` и задать имя пользователя и пароль назначенной учетной записи:

.. code-block:: JSON

    {
        "ProviderName": "Npgsql",
        "ConnectionString": "User ID=xde;Password=1234aA;Host=localhost;Port=5432;Database=XML_GENERATION_DB;MaxPoolSize=500"
    }

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

.. note::
    
    Если планируется использовать PostgreSQL, установленный на другой машине, то в строке подключения нужно указать имя хоста (либо IP-адрес) и порт
    установленного экземпляра PostgreSQL.
	
Настройка подключения к Authentication API
******************************************

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

Для настройки подключения нужно открыть конфигурационный файл ``appsettings.json`` в текстовом редакторе
и задать строку подключения в поле ``AuthenticationApiConnectAddress``, указав имя или IP-адрес хоста и порт для подключения к Authentication API через Nginx:

.. code-block:: JSON

   "AuthenticationApiConnectAddress": "http://192.168.11.128:6133",

.. include:: ../../_Include/DocumentsGeneration/Api/SettingUpNginxAccess.rst

Автоматический запуск Documents Generation API
**********************************************

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

.. code-block:: console

    sudo nano /etc/systemd/system/xde-documents_generation-api.service

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

.. code-block:: ini

    [Unit]
    Description=TerraLink xDEPro Documnets Generation API

    [Service]
    WorkingDirectory=/opt/TerraLink.xDEPro/DocumentsGeneration/DocumentsGeneration.REST
    # доступ извне будет возможен только через Nginx
    ExecStart=/opt/dotnet/dotnet /opt/TerraLink.xDEPro/DocumentsGeneration/DocumentsGeneration.REST/TerraLink.xDEPro.DocumentsGeneration.Rest.Host.dll --urls http://127.0.0.1:6040
    Restart=always
    RestartSec=10
    KillSignal=SIGINT
    SyslogIdentifier=xde-documents_generation-api
    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-documents_generation-api.service
	sudo systemctl start xde-documents_generation-api

.. include:: ../../_Include/DocumentsGeneration/Api/TestingApiAccess.rst