Get Started with Local License Server
Local License Server (LLS) ensures a secure method to provide licensing capabilities for IP Maestro. Here is the procedure to get started with Local License Server.
Resource Requirements
IMPORTANT: The latest version of the Local License Server (LLS) can be deployed on bare-metal servers as well as on Virtual Machines (VM).
Co-hosting with IP Maestro
LLS can be co-hosted on the same server as IP Maestro, provided the server (VM or physical server) is provisioned with the combined total resources required for both applications.
To run LLS, ensure that the host the following minimum dedicated hardware requirements:
• Disk: LLS requires an additional 2GB disk space.
• RAM: LLS consumes an additional 2GB memory.:
Hardware | Required/Version |
|---|
CPU Architecture | X86-64 |
Operating System | Linux |
Operating System Versions | Red Hat Enterprise Linux (RHEL) 9.6 OR Ubuntu 24.04 Debian 13 (trixie) |
Docker Tool Chain | Docker versions 23.0.0 through 28.5.2 |
Note: The validated hypervisor is KVM / QEMU. Using other hypervisors or operating systems may result in dependency issues or instability.
IMPORTANT: To remove any previous installation of the Local License Server, refer to the
Reinstall Local License Server section.
Deploy and Start Local License Server
Procedure
1. Login to Flexnet Operations with the user credentials.
2. Prepare the host server and download the LLS installation tar file
ipi-license-server-prod_2024.08-r1.tar.gz.
mkdir ~/LLS && cd ~/LLS
wget ipi-license-server-prod_2024.08-r1.tar.gz
3. Start the Local License Server for the first time (one time only)
From the local directory, run the following commands to extract the tar file and deploy LLS
ls -lrth ~/LLS/ipi-license-server-prod_2024.08-r1.tar.gz
tar xzf ipi-license-server-prod_2024.08-r1.tar.gz
cd deploy
sudo ./deploy-lls.bash
Licensing Service is deployed. A quick check can be done with an endpoint URL in the browser:
http://< LICENSE_SERVER_IP_ADDRESS>:7077/api/1.0/instances/~
You can also check by running using the curl command on the host, as shown in the below example:
$ ~/LLS/deploy$ curl http://10.0.2.15:7077/api/1.0/instances/~
{
"id" : 211,
"serverInstanceId" : "0YWF0H41YMZQ",
"requestId" : "1",
"tenantId" : "",
"pendingDeletion" : false,
"maintenanceEndTime" : "1970-01-01T00:00:00.000Z",
"suspended" : false,
"ready" : false,
"publisherName" : "IPICO",
"lastUpdateTime" : "1970-01-01T00:00:00.000Z",
"lastSyncTime" : "1970-01-01T00:00:00.000Z",
"failOverRole" : "UNKNOWN_ROLE",
"lastServerToServerSyncTime" : "1970-01-01T00:00:00.000Z",
"lastClientDropTime" : "1970-01-01T00:00:00.000Z",
"identityName" : "ipi-ocnos-prod-1.0.0"
}
Obtain License File
Get the IP Maestro License file from the Flexera portal. Use the MAC address of the management interface of the host server where LLS will be deployed (VM or bare metal).
Get the MAC Address of Management Interface
Either use the ip addr or ifconfig command.
OR
Use the following command after LLS is successfully installed, and the service is up and running.
docker run --rm ipi-license-server-prod:2024.08 ./flexnetlsadmin.sh -server http:// <SERVER_IP_ADDRESS>:7077/api/1.0/instances/~ -hostid
For example:
docker run --rm ipi-license-server-prod:2024.08 ./flexnetlsadmin.sh -server http://10.0.2.15:7077/api/1.0/instances/~ -hostid
{
"selected" : {
"hostidType" : "ETHERNET",
"hostidValue" : "525400EF618F",
"hostidAttributes" : [ "Physical" ]
},
}
In the above example, the MAC address (Host ID) of the server 525400EF618F can be retrieved. Using this MAC address, you can generate the IP Maestro license file from the Flexera Portal.
Activate License File
To activate the license file, use the following steps:
1. Copy the license file to ~/LLS/ipiws/ directory on the host where the license server deployed.
For example:
The license file obtained from Flexera is 525400EF618F.bin
mkdir ~/LLS/ipiws (One time)
cp 525400EF618F.bin ~/LLS/ipiws/
2. Activate the license file using the following command:
docker run --rm -v ~/LLS/ipiws:/ipiws ipi-license-server-prod:2024.08 ./flexnetlsadmin.sh -server http://10.0.2.15:7077/api/1.0/instances/~ -activate -load /ipiws/525400EF618F.bin
To activate the license file on IP Maestro, ensure to use the system IP address for LLS IP address.
Running LLS on the same VM as IP Maestro
Running LLS in the same VM as IP Maestro is more convenient, however, note that it consumes the memory of the VM and causes some impact if IP Maestro is running in high stress. Although this impact would be minimal, you can increase the memory and cores footprint of the VM hosting IP Maestro and LLS.
Maintain Local License Server
After the initial setup, you can stop or restart the licensing service using the following commands:
cd ~/LLS/deploy
docker compose down (stop the license server container)
docker compose up -d (start the license server container)
Reinstall Local License Server
In case Local License Server was previously installed, it must be removed completely as a part of the re-installation. Here are the steps for this procedure:
1. Stop and remove the LLS container that is running
cd ~/LLS/deploy/
docker compose down
docker ps -a | grep deploy-ipi_license_server
Stop and remove the container if present:
docker rm -f <container_id>
2. Remove the existing LLS Docker image
docker rmi -f ipi-license-server-prod:2024.08
3. Remove the existing FlexNet LLS directories. Ensure to delete the existing FlexNet LLS data and binaries for a clean re-installation.
sudo rm -rf /var/opt/flexnetls/
sudo rm -rf /opt/flexnetls/
4. Re-Deploy IP Maestro Local License Server
• Navigate to the LLS deployment directory cd ~/LLS/deploy/
• Run the deployment script bash lls-deploy.bash