Internal documentation only

This page has been marked as draft.

[INTERNAL] How to generate a Control-M, VMware or Nirvana (Terracotta) Licence

This is the licence generation process for legacy Control-M below version 9.0.18 for clients using the integration. Note the integration is no longer supported or available for download. This is different to the Control-M plugin and token in licences managed at the licensedb website.

If a client requests control-m licenses for legacy unsupported integration, follow the steps below.

Generating a licence for the unsupported Control-M integration requires the use of the support library bdIT.jar. This library is used to encrypt a licence key. The process is performed via command line.

Note for Geneos version GA4.10 and above

The Control-M plugin licensing has been integrated with Licence Daemon (LICD). Please add the token to the Geneos license.

Note for Geneos version GA7.1 and above

The VMware plugin licensing has been integrated with Licence Daemon (LICD). Please add the token to the Geneos license.

Known bug: COL-11571: Cannot generate license file using VMWare 1.4.21 package

Please generate the license using VMWareMonitor-1.4.20 or older package.

Step 1 Copied

Download VMware integration from https://resources.itrsgroup.com/downloads#package-vmware-integration

Step 2 Copied

Extract the package and change into the lib directory:

mkdir -p /opt/itrs/packages/vmware
tar -xzvf VMWareMonitor-1.4.22.tar.gz -C /opt/itrs/packages/vmware
cd /opt/itrs/packages/vmware/lib

Step 3:

Ensure that you have Java version 1.7 or above to generate the key:

java -version

Run bdIT.jar with the licence expiry date in yyyymmdd format:

java -jar bdIT.jar 20191024

You will see output similar to the following:

[slowden@localhost lib]$ java -jar bdIT.jar 20191024
ERROR StatusLogger No log4j2 configuration file found. Using default configuration: logging only errors to the console.
d4QNUwBxZITOMijKdwfnug==

[slowden@localhost lib]$

The encrypted licence key in this example is d4QNUwBxZITOMijKdwfnug==

Save the key to a file named ControlmMonitor.lic ensuring correct capitalisation. This is what you will need to provide to the client.

Alternatively, redirect stderr and send the encrypted licence key from stdout straight into a licence file:

java -jar bdIT.jar 20191024 2> /dev/null 1> ControlmMonitor.lic

Note: For VMware, replace ControlmMonitor.lic with VMWareMonitor.lic.

For Terracota, replace ControlmMonitor.lic with UMMonitor.lic.

Step 4:

Provide ControlmMonitor.lic to the client.

Update the Control-M, VMWare and Terracotta Universal Messaging Licences spreadsheet on Sharepoint for tracking purposes.