License Activation

This section explains how products are activated and how to change the active license with the License Information tool.

After a license has been registered in the License Information Dialog it tries to fetch the license data from the license server and display it.
The license details might be inaccurate when there is no internet connection available.
To activate a product on a machine with no internet connection an offline activation is possible, more information on that in the Offline Activation section of this page.

An activation of a license is always bound to a specific user and machine.
When a license is registered on a machine and multiple users start the product, it will create an activation for each user.

Using Serial Number

In order to activate / register a license you first have to open the License Information application. You can find more information where the License Information application is located here.
To activate the license using a serial number follow these steps:

  1. Click the Change license button
  2. In the Type combo box select the licensing model the serial number was issued for
  3. Enter the serial number
  4. Click the Register License button


After that you can close the License Dialog and launch the product.
When a serial number is used to activate the license, the product will automatically create a local copy of the license file on first startup.
This is done for performance reasons and to avoid outages in case of a temporary internet connection problem. The location of the license file is usually %localAppData%\coolOrange\<ProductName>.

Requirements

Activations via serial number require an internet connection.
The following domain needs to be accessible on TCP port 443 'app.cryptolens.io'


Using Activation File

Some of the licensing models support an offline activation process using an activation file and a machine code.
The license activation file can be generated using the serial number and the machine code. Further information on how to generate the activation files can be found on the manage your licenses page.
To activate the license using the activation file follow these steps:

  1. Click the Change license button in the License Information tool
  2. In the Type combo box select the licensing model the activation file was created for
  3. Select the Activation File option
  4. Click the folder icon on the right
  5. Navigate to the activation file using the file selection dialog and click Open
  6. Click the Register License button

It is recommended to place the activation file in the local app data directory of the product (%localappdata%/coolOrange/<productName>/) as it is bound to a specific machine and user.
The users that will use an activation file, need to have at least read permissions for the file.
More information on which licensing models support offline activation can be found in the detailed description of the corresponding model on the Licensing Models page.

Activating via Command-line

To simplify automated activations / deployments the License Information tool can be used without a graphical interface and command line arguments.
The available arguments for the License Information tool are:

License.exe [--Tokens --SerialNumber=<License Serial> ] [--StandAlone [--SerialNumber=<License Serial> | --ActivationFile="<PathToActivationFile>"]]

Example: Activating a Token license using a serial number:

start /Wait License.exe --Tokens --Serialnumber="XXXXX-XXXXX-XXXXX-XXXXX"

Example: Activating a Stand-Alone license using a serial number:

start /Wait License.exe --StandAlone --Serialnumber="XXXXX-XXXXX-XXXXX-XXXXX"

Example: Activating a Stand-Alone license using a downloaded activation file:

start /Wait License.exe --StandAlone --ActivationFile="C:\Users\coolOrange\AppData\Local\coolOrange\powerJobs\licensekey.skm"

After a successful activation the License.exe returns with exit code 0.
In case of a problem during the activation the License.exe returns with exit code -1 and an error message is displayed in the Command-line.

When the –ActivationFile path contains white spaces e.g. C:\Program Files\ it has to be quoted. Absolute or relative paths can be specified, but at the end the path will always be saved as an absolute path.
When passing an invalid activation file but the license bound to the file is valid, the tool will automatically try to get the license over the internet and activate the product.

Offline Activation

Some licensing models support a full offline activation process using an activation file. More information which licensing models support this can be found on the Licensing Models page.
Instructions on how to create and download an activation file can be found on the manage your licenses page.
After generating and downloading an activation file for a specific license, a normal activation using the activation file can be carried out.
If the registered license is not supporting a full offline activation or is not valid, the product will try to connect to the license server to automatically refresh license information.

Renewal

When the license gets renewed a new offline activation file must be generated and the activation has to be carried out again.

In some cases you might want to change the serial number or the used licensing model.
To do that you open the License Dialog and click on the Change License button.
Afterwards you can enter the new serial number.