Go to documentation repository
Installation
Attention!
- License Server cannot be installed on the same computer as Axxon One. If you have Axxon One installed on your computer, you must dedicate a separate computer to install the License Server.
- Port 443 must be open.
To install the private License Server in Linux OS, do the following:
- Create an activation request (see Creating an activation request).
- 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:- 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, to the Downloads folder.
Install the private License Server:
sudo dpkg -i license-server.deb
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
Unzip the keyfile.zip archive, received from an AxxonSoft manager, into the keyfile folder:
sudo mkdir keyfile & unzip keyfile.zip -d keyfile
Go to the keyfile folder:
cd ./keyfile/
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/
Restart the License Server:
sudo systemctl restart license
Add the server.license.key to the /var/AxxonSoft/LicenseServer/keys directory:
sudo cp server.license.key /var/AxxonSoft/LicenseServer/keys
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.
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 Linux OS is complete. To access the License Server web interface, you need to:
- Determine the address of the License Server using the command:
systemctl status license
- Enter the obtained address into the browser's search bar.
As a result, the License Server web interface will open (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.
Note
Metrics are sent either every three minutes or when connection with the License Server is lost.