Installing the private License Server in Linux OS

To install the private License Server in Linux 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.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 manager, 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

    Note

    As a result, two files will be 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

13. Activate the Client license.key on all Axxon One Servers in the domain using the activation utility (see Activation by applying license file).

    Note

    As a result, two files will be located on all Axxon One Servers in the domain at the /opt/AxxonSoft/RaFT/data/Nodes/default/Tickets/path: Client license.key and ngp.ca certificate.

Installing the private License Server in Linux OS is complete.

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 UTC 64-bit format. For example, 1917820800, which corresponds to October 10, 2030 in the value of the license key.