Page History

Installation

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

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

The keyfile.
5. zip
key
6. package
contains


7. Certificate: ngp.licserver.crt

8. Private key: ngp.licserver.key
Server key: server.license
9. .
key

11. Client key: license.key

12. Run the License-server.msi file from the received package
, received from an AxxonSoft manager
13. . The installation
will be
14. is performed in the C:\Program Files\Common Files\VMS\VMS
\VMS
15. License Server directory.
    
After the installation
16. Once installed, the following
will be
17. is added:
    
    1. The VMS License Server program
will be
18. 1. is added
to
19. 1. to Programs and Features.
    2. The VMS_License_Service
will be
20. 1. is added
to
21. 1. to Services. It
will start
22. 1. starts immediately after the installation. After restarting the
Server
23. 1. server, the service
will start
24. 1. starts automatically. In Task Manager in Processes, the process of the running service is called license_service.exe. After completing the process
is finished
25. 1. , a new process
will start
26. 1. starts in one minute.
27. Create an activation request. To do this, you must collect the computer's HIDs using the LS_tool utility by running it in the command line:

    Code Block
    C:\Program Files\Common Files\VMS\VMS License Server>LS_tool.exe --collect-hwinfo

    Note
    title Attention!
    The key binds to the License server, not to Axxon One. When you use the Guardant key, make sure that the USB key is connected to the server where you install the License server.

28. Add the LEASE_ACCOUNTER_TLS_AUTH_ENABLED system variable with the true value
true
29. (see
Appendix 9.
30. Creating system variable).
31. Stop the VMS_License_Service in Services.
32. Send a file with collected HIDs of the computer to the AxxonSoft manager and request the keyfile.zip package for the private License server that contains:

    1. Certificate: ngp.licserver.crt.

    2. Private key: ngp.licserver.key.

    3. Server key: server.license.key.

    4. Client key: license.key.

Add the
33. Unpack the keyfile.zip archive received from the AxxonSoft manager.
34. Add the server.license.key to the C:\Program Files\Common Files\VMS\VMS License Server\keys folder.
35. Rename the ngp.licserver.key private key to
ls
36. private.key and the ngp.licserver.crt certificate to
ls
37. keyfile.crt and add them to the C:\Program Files\Common Files\VMS\VMS License Server folder. Confirm the file replacement.
    
Start the

38. Note
    title Attention!
    When you use the License server of a version lower than 2.1.1, you must rename the ngp.licserver.key and ngp.licserver.crt files to ls.key and ls.crt,respectively.

39. Start the VMS_License_Service.
40. Stop the VMS_License_Service.
41. 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.
42. Start the VMS_License_Service.

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

Possible issues

Connection error

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

In such cases, it is recommended to disable this case, we recommend disabling the firewall on both the Axxon One computer and the License Serverserver computer.

Additionally, ensure that port 443 is not Make sure that port 443 isn't occupied by another process.

License

...

server certificate replacement

In some cases, antivirus software may can replace the certificate received from the License Serverserver (including public certificates), leading to which results in 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 In this , it is recommended to disable case, we recommend disabling traffic interception in the antivirus software. This will ensure that the License Server's certificate the antivirus software. As a result, the certificate from the License server is accepted without modifications, allowing the system to function correctly.

License

...

server error: port 8080 is occupied

The following error may can appear in the License Serverserver 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 the operating system-level restrictions.

To fix In this , it is recommended to disable case, we recommend disabling the IIS (Internet Information Services) service. This will free As a result, it frees up port 8080, allowing the License Serverserver to function properly.