ADTF3 Guides - ADTF License Mechanism

Licenser Tool

The easiest way is to use the integrated User Interface within ADTF Configuration Editor.

With the licenser_tool.exe you are able to activate, import or show already used license information also in command line.

Basically you have to differ between following license types:

SDK to develop adtfplugins and generate plugindescriptions (e.g. for build chains)

Runtime to launch and view ADTF Sessions (e.g. test drivers)

Developer to extend the SDK and runtime features with creating/editing ADTF Sessions (e.g. desktop developer and integrator)

Additional, there can be more license features set, e.g. for using ADTF Toolboxes or 3rd party components.

In ADTF 3.x we differ between following license options:

Single Seat Personal license registered to a single user. Only this user is allowed to use the licensed features.

Floating Contingent of activations of a license, which may be used by a group of users. Licenses are activated, renewed and returned after usage.

Virtual Environment Supposed to be used in virtual machines, containers or cloud environments in general. There is a limit in the amount of parallel activations similar to floating licenses.

Since ADTF 3.17 we have integrated the ADTF Licenser for licenseHUB. Please visit Overview Of Products for detailed information and access the standalone documentation of the license package if required. Please note, that if you still have a legacy MAC-based *.lic file, you can still use it with the renewed license mechanism based on license keys from digitalwerk licenseHUB. But please keep in mind that there might be some additional plugins from digitalwerk store which requires a new license mechanism based key/file. For this, please contact the support to upgrade and replace your license plan.

Command Line usage

First of all let's have a look at the possible options by using the licenser_tool.exe. Just issue the following command: licenser_tool.exe --help

                
licenser_tool

Usage:
        licenser_tool --help
        licenser_tool --version
        licenser_tool --info
        licenser_tool --activate <license_key> [--server <url>] [--force]
        licenser_tool --import <license_file> [--force]
        licenser_tool --deactivate [--server <url>]

Options:
        --help, -h  Print the usage information.
        --version   Print the version information.
        --info      Print license information set on system.
        --activate <license_key>
                    Activate a new volume for given license key (will download and store a license
                    file for this host/user).

        --import <license_file>
                    Import and store an already activated volume matching for this host/user.

        --force, -f If set, the activated license file will be overwritten.
        --deactivate
                    Deactivate license (removes local license file and activation on server).

        --server <url>
                    Option to change licenseHUB server (default is
                    'https://licensehub.digitalwerk.net/').

Additonal information regarding license questions

Loading license within your application

If your application depends on licensed plugins and you are not using the ADTF-Launcher, you must set an environment variable. The internal license mechanism is not able to load the corresponding library. ADTF offers for this approach the environment variable ADTF_LICENSER_PLUGIN. This environment variable has to be set to the corresponding license file.

ADTF_LICENSER_PLUGIN = "$(ADTF_DIR)/bin/licenser.dll" The environment variable must not point to you *.lic-file, which contains your specific library. The environment variable points to the plugin (should be in the bin-directory)

Where to go next?

You want to extract or add something to an .adtfdat file ? The ADTF DAT Tool will make it possible.