Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width50%
Panel
titleOn the page:

Table of Contents


Column

 

Installation

Note
titleAttention!
  • You cannot install the License server along with Axxon One. If you
  • have
  • install Axxon One
  • installed
  • on
  • your
  • a personal computer, then you must
  • dedicate a separate
  • have another computer to install the License
  • Server. You cannot install the License Server together with Axxon One
  • server.
  • Port 443
  • port
  • must be open.

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

  1. Create an activation request (see Creating an activation request).
  2. Contact
  3. an
  4. AxxonSoft
  5. manager
  6. technical support to get the
  7. necessary
  8. required license-server.deb
  9. package and the keyfile.zip key package for the private License Server.
    The keyfile.zip key
  10. package
  11. contains:
  12. Certificate: ngp.licserver.crt
  13. Private key: ngp.licserver
  14. .
  15. key
  16. Server key: server.license.key
  17. Client key: license.key
  18. Copy the received license-server.deb
  19. package, received from an AxxonSoft manager, to
  20. package to the Downloads folder.
  21. Install the private License

  22. Server
  23. server:

    Code Block
    languagebash
    sudo dpkg -i license-server.deb
  24. Create an activation request. To do this, you must collect the computer's HIDs using the LS_tool utility byrunningitin the console as the root user:
    Code Block
    languagebash
    /opt/AxxonSoft/LicenseServer/LS_tool-static --collect-hwinfo
    Note
    titleAttention!

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

    Code Block
    languagebash
    sudo nano /etc/AxxonSoft/LicenseServer/license.conf
  26. Unzip the
  27. 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.

  28. Unzip the keyfile.zip archive

  29. ,
  30. received from an AxxonSoft manager

  31. ,
  32. into the keyfile folder:

    Code Block
    languagebash
    sudo mkdir keyfile & unzip keyfile.zip -d keyfile
  33. Go to the keyfile folder:

    Code Block
    languagebash
    cd ./keyfile/
  34. Add the ngp.licserver.crt certificate and the ngp.licserver.key private key to the /etc/AxxonSoft/LicenseServer/ directory:

    Code Block
    languagebash
    sudo cp ngp.licserver.crt ngp.licserver.key /etc/AxxonSoft/LicenseServer/
  35. Restart the License

  36. Server
  37. server:

    Code Block
    languagebash
    sudo systemctl restart license
  38. Add the server.license.key to the /var/AxxonSoft/LicenseServer/keys directory:

    Code Block
    languagebash
    sudo cp server.license.key /var/AxxonSoft/LicenseServer/keys
  39. Restart the License

  40. Server
  41. server:

    Code Block
    languagebash
    sudo systemctl restart license
  42. Infotitle
  43. Note
  44. As a result, two files

  45. will be
  46. are located at the /var/AxxonSoft/LicenseServer/keys path: server.license.key and a key named as the system ID.

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

    Code Block
    languagebash
    sudo rm /var/AxxonSoft/LicenseServer/keys/server.license.key
  48. Activate the Client license.key on all Axxon One Servers in the domain using the activation utility (see Activation by applying license file).

    Info
    titleNote

    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.

Installation of the private License server in 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:
    Code Block
    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)Installing the private License Server in Linux OS is complete.

Useful commands

Install: 

Code Block
languagebash
dpkg -i license-server.deb

Delete:

Code Block
languagebash
dpkg -r license-server

Restart the service:

Code Block
languagebash
systemctl restart license

Check the status of the service:

Code Block
languagebash
systemctl status license

View the service log:

Code Block
languagebash
journalctl -u license.service -r

Useful commands using Prometheus metrics

Check the status of the service:

Code Block
ngp_license_service_status

Where the response is:

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

Check license expiration time:

Code Block
ngp_license_expire_time_utc

The response contains the time in UTC 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.

Info
titleNote

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