Licenser Tool

Description

The Licenser Tool is the perfect assist for

• easily activating or renewing or upgrading a license key
• simply importing an already (for your system and user) activated or renewed/upgraded license file
• deactivating all license settings set on your system and remove activation on server side
• providing some basic license information

as comfortable command line tooling.

Getting started

For any purpose, please execute the licenser_tool with the option –help, which will give you an overview and detailed information how to set up an ADTF license.

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/').

Check current set license

The command –info will give a detailed information about currently used license, feature set and more.

Online activation (automatically)

If you have connection to licenseHUB server, you can use the –activate command and set the license key here:

licenser_tool --activate <your_license_key>

This will create a new volume activation for your host and user, automatically download a license file and store in your user space.

In case there is already a license file set, please use –deactivate command before or add the –force option to your call

Note: This will work for single seat or floating license plans. For virtual environment (e.g. cloud), there won't be a license file stored. In this case, the licenser_tool is no help for you, please set the environment variable 'ADTF_LICENSE_KEY' within your container image instead.

Offline activation (manually)

Another option is to activate the key manually at the server (default address is https://licensehub.digitalwerk.net/volumes/new) for your system and user.

For example if your target platform has no connection to the licenseHUB server instance for activation (e.g. a in-car setup)

For a persistent setup, you have to copy the file to the correct path in user space (as described above) or let the licenser_tool help you here as well by using the –import command:

licenser_tool --import <your_license_file>

In case there is already a license file set, please use –deactivate before or add the –force option to your call

Deactivation

To stop your registration or free some activation count, you can make use of the licenser_tool in combination with –deactivate. This will remove the stored file from disk and also clears the volume from the server.