• If you have Axxon One installed on your computer, you must dedicate a separate computer to install the License Server. You cannot install the License Server together with Axxon One.
  • 443 port must be open.

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


    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).

    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:

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.

Metrics are sent either every three minutes or when connection with the license server is lost.