Linux Machine License Activation

Linux Machine Applications

Linux Machine Applications written with LEADTOOLS require a LEADTOOLS Linux Machine Runtime License. The Runtime License must be activated within 7 days of the first use.

In order to activate a LEADTOOLS Linux Machine Runtime License, you must run the LEADTOOLS License Activator on the machine that will host your application. The LEADTOOLS License Activator can be found in this directory: "\Support\Common\License\Bin\LTLicActivatior.sh".

You can activate a license in one of two ways:

Automated License Activation

If your machine can connect to the internet, use the automated license activation method.

1. Set the license file paths in the LTLicActivator.sh to the original .LIC file emailed to you from LEADTOOLS. For example:

   leadtools_toolkit_path="/home/LEADTOOLS22" 
   leadtools_native_lib_path="$leadtools_toolkit_path/Bin/Lib/x64/libltkrn.so" 

2. Run LTLicActivator.sh (the LEADTOOLS License Activator) on the machine that will host your application. Set execution, read and write permission on the script and then run the script. For example:

   chmod ugo+xrw /LEADTOOLS22/Support/Common/License/Bin/LTLicActivator.sh 
   sh /LEADTOOLS22/Support/Common/License/Bin/LTLicActivator.sh 

3. The activation script runs on either .NET Core or Java runtime environments. If neither one is installed, the registration fails with a warning and you will need to install one of the supported environments:

    License Activation Failed. 
    Must have DotNetCore or Java runtime installed. 

4. Once the environment is installed, you have the license files, and the paths are correctly updated in the LTLicActivator.sh script, running the script will attempt to connect to the LEADTOOLS License Activation Service and activate this .LIC.

   If the internet connection fails, you will be prompted to contact LEAD sales, skip the next step, and follow the Manual License Activation instructions:

       Connection failure, please send "/LEADTOOLS22/Act/Server.txt" file to LEAD sales 

5. Save the generated .LIC file (i.e., the activated license), and then use it in your application.

Manual License Activation

If your machine cannot connect to the internet, use manual license activation.

1. Run LTLicActivator.sh (the LEADTOOLS License Activator) on the machine that will host your application. Follow the steps 1, 2 and 3 in Automated License Activation.

2. Copy the generated Server.txt containing the generated Machine ID string produced from running the script and no internet access is possible:

   Connection failure, please send "/LEADTOOLS22/Act/Server.txt" file to LEAD sales 

3. On a machine that does have the ability to connect to the internet, visit: https://www.leadtools.com/support/activate-server-license.

4. When you connect to the license portal you will need to log in. Then you can enter the Machine Id string from the Server.txt, and upload the original .LIC file emailed to you from LEADTOOLS.

5. Save the generated .LIC file (i.e., the activated license), and then use it in your application.

Unactivated Runtime License

Note

When you deploy an application that uses LEADTOOLS, it will run for only 7 days with an un-activated Runtime License.

The generated machine .LIC file (i.e., the activated license), can only be used on the machine where it was generated. If you attempt to use it on another machine you will receive an error.

The generated .LIC file (i.e., the activated license), cannot be used with the LEADTOOLS License Activator. Only the original .LIC file emailed to you from LEADTOOLS can be used with the LEADTOOLS License Activator.

For more information about LEADTOOLS Licensing, refer to About Software Developer Kit Licensing.