License Server Installation

14min
A license server provides an efficient and secure way to install and manage licenses to multiple Edge devices (Bare-metal, Docker, VM, K8S). A built-in license server is available with Litmus Edge Manager, so you don't need to complete any additional setup for it. You can also set up and install a license server separately in an air-gapped environment.
After receiving a site license key from the Litmus Central portal., a respective site license can then be activated and added to the license server. 
If you set up the license server with Litmus Edge Manager, see License Server Management﻿ for more information on managing site licenses. 
If you set up the license server without Litmus Edge Manager, see the section below Install Licenses in License Server for more information on adding licenses through the license server. You can also add site-based licenses to individual Litmus Edge instances. See the section below Register License Server to Individual Litmus Edge Instance to learn more. 
License Server with Litmus Edge Manager (Easy)
If your organization has an instance of Litmus Edge Manager along with instances of Litmus Edge, then you can install and manage the license server in Litmus Edge Manager. See License Server Management﻿ and Activate an Edge Device﻿ for more information.
Set Up License Server without Litmus Edge Manager (Advanced)
You can set up a license server without Litmus Edge Manager by completing the steps below. 
Before You Begin
To set up the license server, you will need to do the following:
Install Docker Engine 19.03+ on an Ubuntu or similar Linux system. It can be a VM or Bare-metal. It must be installed separately from any Litmus Edge and Litmus Edge Manager.
Make sure the host system has the correct system time and is connected to any NTP Server for proper time sync. Any change in the system time on the host system will invalidate the license.
Have administrative permissions to execute Docker commands on the host system.
Ensure the Docker Engine is configured to run a Docker run command.
Obtain access to a License Server Docker image, which is available from the Litmus Central portal.
Configure firewall inbound port access to the host and docker container from an external Edge device: 8443 TCP, 8445 TCP. 
Step 1: Generate API Key
You will need to create a unique alpha-numeric API key. 
To generate the API key, enter the following command in a command prompt window:
Shell
# generate a random apikey_secret
# copy the apikey to a safe storage
apikey_secret=$(uuidgen) && echo $apikey_secret
# generate a random apikey_secret
# copy the apikey to a safe storage
apikey_secret=$(uuidgen) && echo $apikey_secret
﻿
Note: After the key is generated, make sure to copy it and store it securely. 
Step 2: Set Server IP and DNS
To set the server IP and DNS, enter the following command in a command prompt window:
Shell
# set the server ip/dns. It should be accessible from the edge device on port 8445
server_url=172.17.0.1:8445
# set the server ip/dns. It should be accessible from the edge device on port 8445
server_url=172.17.0.1:8445
﻿
The server URL is the IP address or the DNS address of the host system. The server IP/DNS you configure in the command should be accessible from the edge device on port 8445.
Step 3: Download License Server Docker Image
To download the license server Docker image: 
1.  Download the service account .json file from the Litmus Central Portal.
2. Open a command prompt window on the host system.
3. Enter the following Linux command to authenticate.
Shell
cat <file_name>.json | docker login -u _json_key --password-stdin https://us-docker.pkg.dev
cat <file_name>.json | docker login -u _json_key --password-stdin https://us-docker.pkg.dev
﻿
The <file_name>.json parameter is the service account file requested from step 1. 
Example: If the .json file is named abc123.json, enter: cat abc123.json | docker login -u _json_key --password-stdin https://us-docker.pkg.dev
Refer to Google's Setting Up Authentication: Service Account Key for more information.
4. Pull the License Server Docker image with the following command. 
Shell
docker pull us-docker.pkg.dev/litmus-sales-enablement/ls/litmus-licensing-server:latest
docker pull us-docker.pkg.dev/litmus-sales-enablement/ls/litmus-licensing-server:latest
﻿
Step 4: Run License Server
To run the license server, enter the following Docker command: 
Shell
# Run License Server docker container
docker run --name=lls -d -v lls-data:/var/lib/litmus -v lls-license:/var/lib/litmus-licensing -p 8443:8443 -p 8445:8445 -e LITMUS_LICENSING_API_KEY=$apikey_secret -e LITMUS_LICENSING_SERVER_URL=$server_url us-docker.pkg.dev/litmus-sales-enablement/ls/litmus-licensing-server:latest
# Run License Server docker container
docker run --name=lls -d -v lls-data:/var/lib/litmus -v lls-license:/var/lib/litmus-licensing -p 8443:8443 -p 8445:8445 -e LITMUS_LICENSING_API_KEY=$apikey_secret -e LITMUS_LICENSING_SERVER_URL=$server_url us-docker.pkg.dev/litmus-sales-enablement/ls/litmus-licensing-server:latest
﻿
If the Docker is not in a running state, an error message will be generated. The $apikey_secret and $server_url are the variables created in Step 1 (API key) and Step 2 (Server IP and DNS). 
Install Licenses in License Server
Once you have set up the license server without Litmus Edge Manager, you can start installing licenses in the License Server. 
Note: If you have already set up a license server through Litmus Edge Manager, see License Server Management﻿ and Activate an Edge Device﻿ to learn how to manage licenses through Litmus Edge Manager. 
Before You Begin
Request the activation key you will need from the Litmus Central portal.
Install a License in Litmus Edge
To install a license in Litmus Edge:
In a web browser, log in to the license server you previously installed in the following format: [license server URL]:[port number]. For example: 10.19.12.48:8443. 
If this is the first time you are logging in to the license server, enter the following default credentials:
Username: admin
Password: password
Click Add License. 
The Add License dialog box appears. 
In the License Key field, enter or paste the activation key you received from Litmus. If you will be upgrading the core license, select the Upgrade Core License check box. 
Add License dialog box
﻿
Click Generate Request. 
Click the Copy icon for the activation request. Then, click the URL (https://litmus.activate.id) to visit the Licensing Portal page. 
Copy icon and URL link
﻿
In the Activation Request box, paste the activation request you copied in the previous step. Then, click the I'm not a robot check box. 
Licensing Portal page
﻿
Click Make License. 
Copy the license key that is created and return to the License server page. 
From the Add License dialog box, click Next. 
In the Activation Data field, paste the license key you copied in step 9. 
Activation Data field
﻿
Click Add. 
The license is added to the license server. 
Register License Server to Individual Litmus Edge Instance
If you set up a license server without Litmus Edge Manager, you have the option of registering the license server to individual Litmus Edge instances. 
Note: If you have already set up a license server through Litmus Edge Manager, see License Server Management﻿ and Activate an Edge Device﻿ to learn how to manage licenses through Litmus Edge Manager. 
To register the license server to an individual Litmus Edge instance: 
From the License Server page, click Authorize Device. 
The Authorize Device dialog box appears. 
In the Device Label field, enter a name for the Litmus Edge instance. 
Click Generate Configuration. 
A configuration key is generated. 
Click Copy & Close. 
The configuration key is copied and the dialog box closes. 
Authorize Device dialog box
﻿
In Litmus Edge, navigate to System > License. 
In the License Server Settings section, click Set Server. 
The Set License Server Configuration dialog box appears. 
Set Server button
﻿
In the Configuration field, paste the configuration key you copied. 
Click Save. 
The license is added to the Litmus Edge instance and the instance is added to the Devices section in the License Server page.
﻿
Updated 21 Nov 2024
Raspberry Pi Installation
Software Updates