Go to documentation repository
Page History
Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Installation
Note | ||
---|---|---|
| ||
|
To install the private License Serverserver in Linux OS, do the following:
- Create an activation request (see Creating an activation request).
- Contact an AxxonSoft manager
- technical support specialist to get the necessary
- necessary license-server.deb package and the keyfile.zip key package for the private License Server
- server.
The keyfile.zip key package contains:- Certificate: ngp.licserver.crt
- Private key: ngp.licserver.key
- Server key: server.license.key
- Client key: license.key
- Copy the license-server.deb package, received from an AxxonSoft manager
- technical support specialist, to
- to the Downloads folder.
Install the private License
Serverserver:
Code Block language bash sudo dpkg -i license-server.deb
- 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 language bash /opt/AxxonSoft/LicenseServer/LS_tool-static --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.
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 language bash sudo nano /etc/AxxonSoft/LicenseServer/license.conf
Unzip the keyfile.zip archive, received from an AxxonSoft manager, into the keyfile folder:
Code Block language bash sudo mkdir keyfile & unzip keyfile.zip -d keyfile
Go to the keyfile folder:
Code Block language bash cd ./keyfile/
Add the ngp.licserver.crt certificate and the ngp.licserver.key private key to the /etc/AxxonSoft/LicenseServer/ directory:
Code Block language bash sudo cp ngp.licserver.crt ngp.licserver.key /etc/AxxonSoft/LicenseServer/
Restart the License
Serverserver:
Code Block language bash sudo systemctl restart license
Add the server.license.key to the /var/AxxonSoft/LicenseServer/keys directory:
Code Block language bash sudo cp server.license.key /var/AxxonSoft/LicenseServer/keys
Restart the License
Serverserver:
Code Block language bash sudo systemctl restart license
As a result, two files
will be are located at the /var/AxxonSoft/LicenseServer/keys path: server.license.key and a key named as the system ID.
Delete the server.license.key from the /var/AxxonSoft/LicenseServer/keys directory:
Code Block language bash sudo rm /var/AxxonSoft/LicenseServer/keys/server.license.key
title | Note |
---|
Activate the Client license.key on all Axxon One Servers in the domain using the activation utility (see Activation by applying license file).
Info | ||
---|---|---|
| ||
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:
- Figure out the address of the License server using the command:
Code Block systemctl status license
- 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 | ||
---|---|---|
| ||
dpkg -i license-server.deb |
Delete:
Code Block | ||
---|---|---|
| ||
dpkg -r license-server |
Restart the service:
Code Block | ||
---|---|---|
| ||
systemctl restart license |
Check the status of the service:
Code Block | ||
---|---|---|
| ||
systemctl status license |
View the service log:
Code Block | ||
---|---|---|
| ||
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
- 0—the service is working;
- greater than or equal to 1—there
- 1—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 , which corresponds to October 10, 2030, in the value of the license key.
Info | ||
---|---|---|
| ||
Metrics are sent either every three minutes or when connection with the license License server is lost. |