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).
2. Contact an AxxonSoft
manager
3. technical support specialist to get the
necessary
4. necessary License-server_InstallerWix.zip package and the keyfile.zip license key package for the private License
Server
5. 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

6. Run the
setup
7. License-server.
exe
8. msi file from the package
,
9. received from an AxxonSoft
manager
10. technical support specialist. The installation
will be
11. is performed in the C:\Program Files\Common Files
\VMS
12. \VMS\VMS License Server directory.
    
After the installation
13. Once installed, the following
will be
14. is added:
    
    1. The VMS License Server program
will be
15. 1. is added
to
16. 1. to Programs and Features.
    2. The VMS_License_Service
will be
17. 1. is added
to
18. 1. to Services. It
will start
19. 1. starts immediately after the installation. After restarting the
Server
20. 1. server, the service
will start
21. 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
22. 1. , a new process
will start in one minute.
23. 1. starts in one minute.
24. 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.

25. Add the LEASE_ACCOUNTER_TLS_AUTH_ENABLED system variable with the true value (see Appendix 9. Creating system variable).
Stop the
26. Stop the 
27. VMS_License_Servicein Services.
28. Add the server.license.key to the C:\Program Files\Common Files\VMS\VMS License Server\keys folder.
29. 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.
30. Start the VMS_License_Service.
31. Stop the VMS_License_Service.
32. 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.
33. Start the VMS_License_Service.
34. Activate the Client license.key on all Axxon One Servers in the domain using the activation utility (see Activation by applying license file).

Installing the private License Server in Windows OS is complete.

Possible errors:

1. Axxon One doesn’t see the License Server—try disabling firewall on both computers, also check if 443 port isn’t already in use.
2. The following error is in the License Server logs: C:\Program Files\Common Files\VMS\VMS License Server\logs

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

Possible issues

Connection error

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

In this case, we recommend disabling the firewall on both the Axxon One computer and the License server computer.

Make sure that port 443 isn't occupied by another process.

License server certificate replacement

In some cases, antivirus software can replace the certificate received from the License server (including public certificates), 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:

In this case, we recommend disabling traffic interception in 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 can 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 the operating system-level restrictions.

In this case, we recommend disabling the IIS (Internet Information Services) service. As a result, it frees up port 8080, allowing the License server to function properly       try stopping the IIS service.