Licensing#

Introduction#

This document outlines the types of licenses available for 3LC and describes the methods by which the software picks up the license key. The licensing checks are done on import tlc, which also happens as part of starting the Object Service.

License Types#

All licenses are configured and recognized in the same way, but 3LC supports two different licensing schemes.

Hosted Floating License#

A Hosted-Floating License allows multiple users to share a pool of licenses located on a central license server. The license server will manage the allocation and deallocation of licenses to connected users.

Note: If the Object Service is not shut down in a regular way, it will hold the floating license for an hour. In case of abrupt termination, you can release the license by starting and stopping the Object Service again on the same machine.

Node-Locked License#

A Node-Locked License is restricted to a specific machine. The Object Service will verify the license with a central license server on startup.

Setting Up the License#

Set the TLC_LICENSE environment variable.

  • If TLC_LICENSE contains a file path, the software will read the contents of that file and use it as the license key.

  • If TLC_LICENSE contains a string (that is not a file path), the software will use that string as the license key.

# To set the environment variable to a file
set TLC_LICENSE=C:/path/to/license/file

# To set the environment variable to a string
set TLC_LICENSE=your_license_key_here

# To set the environment variable to a file
export TLC_LICENSE=/path/to/license/file

# To set the environment variable to a string
export TLC_LICENSE=your_license_key_here