.. _Install_Windows_CDF_InstallingWorker:

Установка рабочего процесса
###########################

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

.. code-block:: console

    Copy-Item ".\TerraLink.xDEPro\CDF.Worker.WindowsService" -Destination "$($env:ProgramFiles)\TerraLink.xDEPro\CDF\CDF.Worker.WindowsService" -Recurse

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

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

.. code-block:: console

    Rename-Item -Path "$($env:ProgramFiles)\TerraLink.xDEPro\CDF\CDF.Worker.WindowsService\appsettings.SqlServer.CDF.json.demo" -NewName "appsettings.json"

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

.. code-block:: console

    notepad "$($env:ProgramFiles)\TerraLink.xDEPro\CDF\CDF.Worker.WindowsService\appsettings.json"

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

.. code-block:: JSON

    {
        "ProviderName": "Microsoft.Data.SqlClient",
        "ConnectionString": "Server=.\\SQLEXPRESS;Database=CDF_DB;User Id=sa;Password=1234aA;MultipleActiveResultSets=true;Max Pool Size=500;TrustServerCertificate=True"
    }

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

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

Автоматический запуск рабочего процесса
***************************************

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

.. code-block:: console

    $name="xde-cdf-worker"
    $displayName="TerraLink xDEPro Printforms Worker"
    $binaryPathName="$($env:ProgramFiles)\TerraLink.xDEPro\CDF\CDF.Worker.WindowsService\TerraLink.xDEPro.CDF.Worker.Host.Service.exe"
    $credential=".\xdeadmin"
    New-Service -Name $name -DisplayName $displayName -BinaryPathName $binaryPathName -Credential $credential

где ``.\xdeadmin`` - локальный пользователь, от имени которого ведется установка Продукта.

Затем в командной строке нужно задать пароль для выбранного пользователя:

.. code-block:: console
    
    PowerShell credential request
    Enter your credentials.
    Password for user .\xdeadmin: ******

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

.. code-block:: console

    Start-Service xde-cdf-worker

Проверка доступности рабочего процесса
**************************************

Рабочий процесс не имеет собственного веб-интерфейса.
При этом можно проверить статус сервиса:

.. code-block:: console
    
    Get-Service xde-cdf-worker

В результате в терминал должна быть выведена информация о текущем статусе сервиса:

.. code-block:: console

    Status   Name               DisplayName
    ------   ----               -----------
    Running  xde-cdf-worker     TerraLink xDEPro Printforms Worker