License Templates

A license template acts as a blueprint for the licenses you create for your customers. Before you start creating licenses, you need to create a license template that contains the default values for the license fields.

While creating a license from any license template, you can override all the properties of the license template. The license template provides you with default values for all the properties of a license, so you don't have to provide them every time you create a new license.

Creating a license template

You can easily create a license template through the admin portal. Go to the license templates section in the admin portal and click the create button. A license template form with the following fields will popup:

Name

The name of the license template.

Type

There are three types of licenses:

• Node-locked: This is the default type that locks the license to the machine.

• Hosted Floating: This type is used for creating a hosted floating license.

• On-Premise floating: This type is used for creating an on-premise floating license.

Subscription Interval

To define a recurring subscription, use the subscriptionInterval property to specify the interval and the subscriptionStartTrigger to determine when that duration begins.

• Subscription Interval accepts intervals using ISO8601 durations (P1Y, P3M10D, P30D). This automatically accounts for varying lengths of months and years.

• Subscription Start Trigger controls when the subscription period begins:

  • License Creation: The subscription starts when the license is created, useful for aligning with the purchase date.

  • License Activation: The subscription starts when the license is activated for the first time.

Lease duration

This option is valid for hosted-floating and on-premise-floating license types only. It sets the duration for which you want to lease the floating license.

In case of hosted-floating license type, if you want the license lease to auto-renew then ensure that the server sync interval is less than lease duration by a difference of at least 30 seconds. In order to allow unlimited lease duration, this property can be set to 0 or -1.

In the case of on-premise license type, lease duration can be set to 0 to honor the lease duration set in the LexFloatServer config file.

Leasing strategy

This option is valid for on-premise-floating and hosted-floating license types only. It allows for the following strategies:

Per-Machine:

Each machine will only consume a single floating license/activation, irrespective of the number of instances (processes) of your app being run on the machine.

Per-Instance:

Each instance (process) of your app will consume a separate floating license/activation, irrespective of whether the instances are running on the same machine or different machines.

In case of hosted-floating license type, if you want to use a per-instance leasing strategy, ensure that the permission flag in the LexActivator SetProductId() function is set to LA_IN_MEMORY.

Allowed floating clients

This option is valid for on-premise floating license type only. It sets the maximum number of concurrent clients that can lease the floating license from the server.

For hosted floating licenses, the maximum number of concurrent clients that can lease the license from the server is determined by allowedActivations property

Allowed activations

Allowed number of activations (seats) for the license. If you allow (say) 10 activations for a license, then the license can be used on 10 different machines.

In order to allow unlimited activations, this property can be set to 0 or -1.

Allowed deactivations

Allowed number of deactivations for the license. This setting is ignored for hosted-floating licenses.

In order to allow unlimited deactivations, this property can be set to -1.

The default value for Hosted-Floating licenses is set to -1, indicating unlimited deactivations.

Server sync interval

Whenever the application starts (andIsLicenseGenuine() is called the first time), the server sync occurs immediately in a separate thread. This setting determines the interval for further server syncs till the application is not closed.

The minimum allowed server sync interval up to the STARTUP plan is 3600 seconds, and for higher plans, it is 180 seconds. It is highly recommended to set it to 3600 or greater unless required.

Server sync grace period

The duration for which the server sync failure due to network error is acceptable.

In order to allow an infinite grace period, this property can be set to "-1".

Allowed clock offset

The allowed difference between the network time and the system time. This can be used to allow license activations on machines where system clocks run behind the network time.

Fingerprint matching strategy

LexActivator generates a structured fingerprint of the machine which allows for multiple fingerprint matching strategies. It allows for the following strategies:

Exact:

This strategy requires an exact match of all the hardware parts which were fingerprinted. If there is a minor change in the hardware, the fingerprint will not be accepted, and the machine will be treated as a different machine.

Fuzzy:

This strategy uses fuzzy matching by comparing different hardware fingerprints and if the comparison score is greater than a minimum threshold value, the machine is accepted. This is the recommended strategy.

Loose:

This strategy is similar to fuzzy but with a much lower threshold value.

Sometimes few machines misbehave by reporting major changes in hardware fingerprints due to many issues, in such cases, you should change the strategy to "Loose".

Required metadata keys

List of required metadata keys that a license using the license template must have.

Required meter attributes

List of required meter attributes which a license using the license template must have.

Expiring soon event offset

The number of seconds to wait before the license expiration date to trigger the license.expiring-soon webhook event.

Key pattern

Regex for the license key format. The default regex is ^([A-F0-9]{6}-){5}[A-F0-9]{6}$ which generates the license keys in the format:XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX

Allowed countries

List of the allowed countries. The country name is resolved using the IP address. If none of the countries is selected, then all the countries are allowed.

Disallowed countries

List of the disallowed countries. The country name is resolved using the IP address. If none of the countries is selected, this setting is ignored.

Allowed IP range

IP address range in CIDR notation e.g. 196.210.135.105/24. If no range is specified, then all the IP addresses are allowed.

Allowed IP addresses

List of the allowed IP addresses. If none of the IP addresses is included, then all the IP addresses are allowed.

Disallowed IP addresses

List of the disallowed IP addresses. If none of the IP addresses is included, this setting is ignored.

Allow VM activations

Whether to allow an activation inside a virtual machine. Cloned virtual machines may report the same fingerprint.

Allow Container activations

Whether to allow an activation inside a container. This must never be set to true for an on-premise floating license.

Allow Client Lease Duration

Whether to allow the client app to set the lease duration for the hosted-floating license activation.

User locked

It prevents multiple users inside an OS from using the same license key. If enabled, each user will consume a license activation from the allowed number of activations for a license.

Disable geolocation

In case you don't want to store the IP address and location of the license activation, you can set this property to true.