Installing the private License Server in Windows OS

Installation

To install the private License Server in Windows OS, do the following:

1. Create an activation request (see Creating an activation request).
2. Contact an AxxonSoft manager to get the necessary License-server_InstallerWix.zip package and the keyfile.zip license key package for the private License Server.
   The keyfile.zip key package contains:
   

   1. Certificate: ngp.licserver.crt

   2. Private key: ngp.licserver.key

   3. Server key: server.license.key

   4. Client key: license.key

3. Run the License-server.msi file from the package, received from an AxxonSoft manager. The installation will be performed in the C:\Program Files\Common Files\VMS\VMS License Server directory.
   After the installation, the following will be added:
   
   1. The VMS License Server program will be added to Programs and Features.
   2. The VMS_License_Service will be added to Services. It will start immediately after the installation. After restarting the Server, the service will start automatically. In Task Manager in Processes, the process of the running service is called license_service.exe. After the process is finished, a new process will start in one minute.
4. Add the LEASE_ACCOUNTER_TLS_AUTH_ENABLED system variable with the value true (see Appendix 9. Creating system variable).
5. Stop the VMS_License_Service in Services.
6. Add the server.license.key to the C:\Program Files\Common Files\VMS\VMS License Server\keys folder.
7. Rename the ngp.licserver.key private key to ls.key and the ngp.licserver.crt certificate to ls.crt and add them to the C:\Program Files\Common Files\VMS\VMS License Server folder. Confirm the file replacement.
8. Start the VMS_License_Service.
9. Stop the VMS_License_Service.
10. In the C:\Program Files\Common Files\VMS\VMS License Server\keys folder, delete the server.license.key. Only the key named as the system ID must remain in the folder.
11. Start the VMS_License_Service.

Installing the private License Server in Windows OS is complete. The License Server web interface will be available at https://127.0.0.1:444/ (see Logging in to the License Server web interface).

Possible issues

Connection error

Axxon One may fail to establish a connection with License Server. This can occur due to network-level connection blocking.

In such cases, it is recommended to disable the firewall on both the Axxon One computer and the License Server computer.

Additionally, ensure that port 443 is not occupied by another process.

License Server certificate replacement

In some cases, antivirus software may replace the certificate received from the License Server (including public certificates), leading to errors in the logs:

~[22384]; 2024-05-28; 10:34:59.557; DEBUG;  /LicenseService/App/: ngp certificate path: C:/ProgramData\ITV\IntellectX\Tickets\ngp.ca
~[22384]; 2024-05-28; 10:34:59.620; ERROR;  /LicenseService/App/: HttpClient: error in performing http request -  err:Peer certificate cannot be authenticated with given CA certificates, method:POST, headers:

To resolve this, it is recommended to disable traffic interception in the antivirus software. This will ensure that the License Server's certificate is accepted without modifications, allowing the system to function correctly.

License Server error: port 8080 is occupied

The following error may appear in the License Server logs:

{"app":"LicenseServer","err":"listen tcp :8080: bind: An attempt was made to access a socket in a way forbidden by its access permissions.","level":"error","msg":"exited with error","time":"2022-06-09T09:23:59.471","version":{"PlanKey":"ASIP-LSG","BranchName":"develop","BuildNumber":"69","RevisionNumber":"e89e4088018e47ed982d6f74ed9c4abecde94859"}}

This error indicates that the server cannot use port 8080 due to operating system-level restrictions.

To fix this, it is recommended to disable the IIS (Internet Information Services) service. This will free up port 8080, allowing the License Server to function properly.