Unattended license key installation and activation

591 views 1

All ThinPrint or Cortado license keys can be installed with the License Manager. The following sections explain how license keys can be distributed and activated.

Components for unattended licensing

  • License Manager
    The program component for entering and activating license keys is named License Manager.
  • License file
    This text file contains a list of the servers (onto which the licenses shall be entered) and the assigned license keys in the following syntax:

<IP address>:<license key>
or
<host name>:<license key>
The licenses file uses the .txt format and has to be ANSI coded (not Unicode).

 license file for licensing two servers (example)

license file for licensing two servers (example)

Note! If you wish to install or activate license keys on Microsoft Failover Clus­ters (up to Windows Server 2008 R2), make sure that the appropriate cluster node, and not the cluster instance, is selected as the server address (target host) in the license file. (Failing to do so will result in passing the licenses through to the cluster node that is active at that moment, and that may be the wrong one.

  • Activation file
    The activation file is created automatically by License Manager. Its structure is the same as that of the license file – with two exceptions:

    • After installation of license keys, it also includes the hardware specific regis­tration keys. The activation file is sent in this form to ThinPrint.
    • ThinPrint adds the activation keys to the activation file and returns it to you. This file is used for activation.
      The activation file will then contain an entry for each server as follows:

<IP address>:<license key>:<registration key>:<activation key>
or
<host name>:<license key>:<registration key>:<activation key>
The activation file also uses the .txt format and has to be ANSI coded (not Uni­code).

  • Log file
    The activation file created after the licenses have been entered contains addi­tional information about the ensuing licensing process and therefore also serves as a log file. Should errors occur, this file will include their error messages, which are helpful during troubleshooting.

Process

Prerequisite: License Manager must already be installed wherever license keys are going to be activated. For example, this will have been done automatically when installing ThinPrint Engine.

  • Open the command prompt. Change to C:\Program Files\Common Files\Thin­Print if necessary.
  • Start automatic license input with:
    rundll32 "<path>\TPLicMMC.dll",Licman -u:"<path>\<license file>" -w:"<path>\<activation file>"
    Example:
    rundll32 TPLicMMC.dll,Licman -u:licenses.txt -w:activa­tion.txt

    starting unattended licensing (example)

    starting unattended licensing (example)

    It is required to enter the parameter -w and specify the activation file; any name can be chosen for the activation file (format: .txt; ANSI coded, not Uni­code). A parameter description can be found in the section License Manager parameters.

    Note! If the license file contains several server addresses License Manager executes the installation, as well as the activation, of license keys remotely.
    Prerequisite: License Manager must already be installed on the remote servers and can be reached.

  • Complete the activation file
    Afterwards upload the activation file in the Cortado Enterprise Por­tal (enterpriseportal.cortado.comCustomer View) by clicking the import button ().
activation file after licensing two servers (example)

activation file after licensing two servers (example)

 importing an activation file to the Enterprise Portal

importing an activation file to the Enterprise Portal

Then you will receive the activation file by e-mail. Additionally it contains both activation keys and subscription keys.
These keys will also be displayed in the Enterprise Portal. Alternatively, you can download them here as an activation file – using the export button ().

activation file returned by Cortado or downloaded from the Enterprise Portal (example for two servers)

activation file returned by Cortado or downloaded from the Enterprise Portal (example for two servers)

 

exporting the activation file from the Enterprise Portal

exporting the activation file from the Enterprise Portal

()

Automatic activation

  • Exchange the activation file uploaded to the Cortado Enterprise Portal for the one got back.
    The activation keys can now be read in. To do so, open License Manager again with parameters:

rundll32 "<path>\TPLicMMC.dll",Licman -u:"<path>\<acti­vation file>" [-w:"<path>\<log file>"]
Example:
rundll32 TPLicMMC.dll,Licman -u:activation.txt -w:thin­print.log

 starting unattended activation (example)

starting unattended activation (example)

  • Check the success of your activation in the log file or in the Graph­ical User Interface (GUI) of License Manager (screenshot after the following).
 log file after activation – with success and error messages (example)

log file after activation – with success and error messages (example)

 License Manager after activating a server (example)

License Manager after activating a server (example)

 

Automatic renewal of update subscription

Automatically entering and activating licenses also lets you renew your Update Subscriptions. If the activation file sent by ThinPrint does not already include subscription keys, enter the server address and the relevant sub­scription key in a separate line. The syntax for entering a subscription key is the same as the syntax for a license key.

Note! Activation and subscription can be made in a single step by adding the subscription key to the activation file and loading these as above. Please note the correct sequence:<address>:<license key>:<registration key>:<activation key><address>:<subscription key>

Alternatively, the subscription key can also be entered later by opening License Manager after the license has been activated (see above section 2.).

Deleting license keys

Caution! License Manager offers the possibility of deleting license keys irrevocably (using the Destroy License function). Be aware however, that once license keys have been destroyed they can not be reentered – not even if they had been previously activated!

License Manager parameters

Parameter Meaning …
… with automatic license input … with automatic activation
-u
Path to the license file Path to the activation file (got back from ThinPrint)
-w
Path to the activation file (to be sent to ThinPrint) Path to the log file
Previous Page
Next Page

Was this helpful?