Installation

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

1. Create an activation request. To do this, you must collect the computer's HIDs using the LS_tool utility by running it in the console under the root user:

   /opt/AxxonSoft/LicenseServer/LS_tool-static --collect-hwinfo

   The key binds to the License Server, not to Axxon One. When using the Guardant key, make sure that the USB key is connected to the server where you install the License server.

2. Contact an AxxonSoft technical support specialist to get the necessary license-server.deb package and the keyfile.zip 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. Copy the license-server.deb package, received from an AxxonSoft technical support specialist, to the Downloads folder.

4. Install the private License Server:

   sudo dpkg -i license-server.deb

5. Make sure that there is a LEASE_ACCOUNTER_TLS_AUTH_ENABLED=true variable at the /etc/AxxonSoft/LicenseServer/ path in the license.conf configuration file. If the variable is missing, run the following command:

   sudo nano /etc/AxxonSoft/LicenseServer/license.conf

6. Unzip the keyfile.zip archive, received from an AxxonSoft manager, into the keyfile folder:

   sudo mkdir keyfile & unzip keyfile.zip -d keyfile

7. Go to the keyfile folder:

   cd ./keyfile/

8. Add the ngp.licserver.crt certificate and the ngp.licserver.key private key to the /etc/AxxonSoft/LicenseServer/ directory:

   sudo cp ngp.licserver.crt ngp.licserver.key /etc/AxxonSoft/LicenseServer/

9. Restart the License Server:

   sudo systemctl restart license

10. Add the server.license.key to the /var/AxxonSoft/LicenseServer/keys directory:

    sudo cp server.license.key /var/AxxonSoft/LicenseServer/keys

11. Restart the License Server:

    sudo systemctl restart license

    As a result, two files are located at the /var/AxxonSoft/LicenseServer/keys path: server.license.key and a key named as the system ID.

12. Delete the server.license.key from the /var/AxxonSoft/LicenseServer/keys directory:

    sudo rm /var/AxxonSoft/LicenseServer/keys/server.license.key

Installing the private License Server in the Linux OS is complete. To access the License Server web interface, do the following:

1. Figure out the address of the License Server using the command:
   

   systemctl status license

2. Enter the obtained address into the browser's search bar.

As a result, the License Server web interface opens (see Logging in to the License Server web interface).

Useful commands

Install: 

dpkg -i license-server.deb

Delete:

dpkg -r license-server

Restart the service:

systemctl restart license

Check the status of the service:

systemctl status license

View the service log:

journalctl -u license.service -r

Useful commands using Prometheus metrics

Check the status of the service:

ngp_license_service_status

Where the response is:

• 0—the service is working;
• greater than or equal to 1—there are problems in the service operation.

Check license expiration time:

ngp_license_expire_time_utc

The response contains the time in 64-bit Unix format. To convert the response to date and time format, you can use any available converter (for example, https://timeconverter.online/). For example, 1917820800 corresponds to October 10, 2030, in the value of the license key.