How do I lease different license types with one Licensing Server?

 

If an organization has more than one license server subscription, these licenses can be distributed by the same server. 

 

The server will have a list of toolsets with unique licenseEntitlementGroupId values, which specify each license type assigned to the organization. To see all available product identifiers, go to the server admin status page and see the list under licenseEntitlementGroupId.

 

To manage which license is leased from a server with multiple toolsets, you have two main options: a client-side configuration or a server-side configuration.

Option 1: Client-Side Configuration (recommended)

To request a specific license, you need to specify the value of the “toolset” in the services-config.json file on the client machine. If a client wants to request different licenses depending on availability, you can separate each license toolset with a comma. The first license type specified in the list will be prioritized in this case. For example:

 

{ 
"licensingServiceBaseUrl": "http://SERVER-IP-ADDRESS:PORT",
"enableEntitlementLicensing": true,
"enableFloatingApi": true,
"clientConnectTimeoutSec": 5,
"clientHandshakeTimeoutSec": 10,
“toolset”: "LicenseServer_12345678901234_2,LicenseServer_12345678901235_2"
}

 

If multiple licenses are available on the server and the client is not requesting any specific one, the default one will be served, as decided in the setup of the license server. However, if the default value is not set during the setup of the server, the first available license from the list available on the admin status page will be served.

Option 2: Server-Side Configuration

As an alternative, you can modify the server's configuration to automatically allocate the first available license. This is achieved by removing the defaultToolset key from the licensing-server-config.json file on the license server. After removing the key, a server restart is required. Details on the server configuration file can be found here.

Please note that removing the defaultToolset key from licensing-server-config.json will result in the server showing a “Degraded” status in the logs and dashboard.

 

 

To see all available license toolsets, go to the server admin status page at http://SERVER-IP-ADDRESS:PORT/v1/admin/status and view the list under licenseEntitlementGroupId.

 

You can find services-config.json in the following directories on your client machine depending on its operating system: