====== Сервер лицензий ======

Сервер лицензий - это служба, которая хранит у себя список лицензий и выдает их запросившим лицензии программам. Лицензии генерируются для определенной конфигурации компьютера. Идентификатор конфигурации называется HWID. Если конфигурация меняется, то меняется HWID и ключ нужно переполучить.\\
Сетевой TCP порт, по которому идет обмен информацией сервера лицензий с программами - **19170**.

===== Установка =====

Для установки службы нужно выполнить команду:\\
**LicensingService.exe /install**

===== Получение нового ключа =====

Ключ в большинстве случаев обновляется автоматически, примерно раз в месяц. Обновляется ключ за 3 дня до окончания прошлого ключа.\\
Если у компьютера сменилась конфигурация, то нужно получить ключ для нового HWID. Сделать это можно, запустив программу с таким параметром:\\
**LicensingService.exe /reg**

===== Параметры командной строки =====
Установка службы: \\
/install \\
Удаление службы: \\
/uninstall \\
Получение ключа вручную: \\
/reg \\

===== Параметры конфигурационного файла =====

Все параметры службы сервера лицензий хранятся в файле LicensingService.ini. Заполняются параметры автоматически, при первом получении ключа. Дальше параметры также обновляются в автоматическом режиме. \\
\\
Иногда нужно внести изменения в конфигурационный файл вручную. Например, если нужно указать отличный от 19170 TCP порт. \\
Все описанные ниже параметры относятся к серверу лицензий, начиная с версии 4.6.0.1.

Подключение к базе данных:\\
<code>
[Firebird]
Server=127.0.0.1
Port=3050
DB=c:\Agbis\DB\ARM.fdb
Password=
</code>

Если нужно, чтобы сервер лицензий сохранял информацию о сроке действия лицензий не только в основную базу данных, но и в дополнительную, то можно добавить еще до 9 разделов FIREBIRD. У 
каждого раздела должен быть номер от 1 до 9. Например: \\

<code>
[Firebird1]
Server=127.0.0.1
Port=3050
DB=c:\Agbis\DB\ARM_DEP.fdb
Password=
</code>

Основной раздел:\\
<code>
[Main]
// Идентификатор подразделения
LastGUID=4F7XXXXXX-9YYY-4XXX-9YYY-01ZZZZZZZZZ
// Идентификатор конфигурации компьютера
LastHWID=CHVUQ1IXXXXXXXXXXX
// Последняя дата успешного переполучения ключа
LastKeyWrite=23.06.2023
// Дата окончания ключа
ExpireDt=15.07.2023
// Tcp порт, который будет прослушиваться и на который будут приходить запросы из программ
TcpPort=19170
// Шаблон расписания, указывающий в какое время будет происходить автоматическое переполучения ключа. По умолчанию - в 11:00 и в 18:00
CRON=0 0 11,18
// Будет ли сервер лицензий обновлять себя при появлении на сайте новой версии . По умолчанию 1, значит Да. Если автообновление не требуется, то нужно выставить 0
AutoUpdateEnabled=1
// Будет ли сервер лицензий обновляться на тестовую версию. По умолчанию 0, значит Нет. Если требуется обновление на тестовую версию, то нужно выставить 1
AutoUpdateToTestVers=0
</code>

Раздел наименований для службы сервера лицензий. Менять требуется, если на компьютере нужно запустить несколько экземпляров сервера лицензий. У каждого экземпляра сервера лицензий должен быть уникальный порт и названия ниже: \\
<code>
[Service]
ServiceName=Db1
ServiceDisplayName=Db1
</code>

<ifauth @user>
===== Названия файлов, наша информация =====
Сервер лицензий имеет название файла LicensingService.exe . \\
Новая и самая правильная версия у нас в \\\Secure FTP\Share42\Agbis\_NonVersion\ называется LicensingServiceHD.exe . В этой версии идет отличное от старой наименование некоторых внутренних параметров. Из-за этого при переходе на HD версию со старой - меняется HWID и нужно переполучать ключ.\\
На компьютере клиентов любая версия должна называться LicensingService.exe.

===== Несколько одновременно работающих СЛ =====
Для минимизации трудозатрат при установке нескольких СЛ на одном компе, рекомендую для каждого СЛ прописывать в названии службы номер порта. Тогда можно быстро найти на каком порту работает какой клиент и какой порт можно использовать для следующего клиента.\\
В папке клиента в LicensingService.ini:\\
<code>
[Main]
...
TcpPort=19171
...
[Service]
ServiceName=19171_ClientNameInEnglish
ServiceDisplayName=19171_ClientNameInEnglish
</code>

<WRAP round important 60%>
Эти настройки работают только на LicensingServiceHD\\
Скачать новый СЛ можно здесь:
\\\Secure FTP\Share42\Agbis\_NonVersion\LicensingServiceHD.exe

</WRAP>


Для того, чтобы AgentNG работал с сервером лицензий на другом порту, необходимо переключить AgentNG и классический агент на тестовые, и перезапустить их на сервере. После этого необходимо будет порт, который мы указали в конфигурации сервера лицензий, также указать в глобальной настройке "Порт компьютера с сервером лицензий", эта глобальная настройка должна подтянуться вместе с тестовым обновлением AgentNG. После того, как указали порт в глобальной настройке, необходимо еще раз перезапустить AgentNG и проверить в логе AgbisAgentNG_Service, к тому ли порту идет подключение, и привязались ли лицензии.

В логах мы должны увидеть запись следующего вида:
<code>05.07.2023 09:46:50:193 [6408]: Адрес сервера лицензий: 127.0.0.1:19171
05.07.2023 09:46:50:416 [6408]: Кол-во АЦех(WL): 1
05.07.2023 09:46:50:416 [6408]: Кол-во АПриёмка(ML): 2 </code>

Это значит, что агент работает с сервером лицензий, на нужном порту и подтянул из него необходимые лицензии
</ifauth>