How to View and Activate your licenses

Using the License Manager to View and Activate your licenses

To view, activate and download your licence for use, please follow these steps.

View Purchases

To view your purchases, click on ‘License Manager’ in the navigation panel on the left of the MyDelta page. You will then see a table of all purchases that you are a technical contact for, each of which can be expanded to display the individual line items underneath each purchase.


If you have made a purchase but cannot see any on this page, you will need to be assigned as a technical contact for the purchase. If this is the case please contact us via our support portal with your purchase information and invoice.

Activate System

After expanding your purchase, you will see a list of systems. Each system corresponds to a license, and must be activated to associate it with a hostid such as a hostname or IP address, before license files can be generated and downloaded. You can read more about our license models and the information you need to generate you license in the Licensing models section and the necessary procedures elsewhere in this Procedures section.

Download License

How you license is ready to download, so simply click on the ‘Download’ link and the file will start downloading.

View System History

These actions and others will be visible in the system history, just click the link to see the Activation and Download actions.

Using the License CLI to View and Activate your licenses

To view, activate and download your licence for use, please follow these steps.

Authenticate

Before access is granted to any licensing information, you need to authenticate using the command below:

$ java -jar licensing-cli-1.0.0.jar auth

The License CLI will then provide you with a URL and instruct you to follow it to authenticate. Once you have used the URL in a browser and gone through the authentication prompt on the website, the License CLI will acknowledge your authentication and tell you where your access key is stored and for how long it will last. The browser authentication process does not need to run on the same system as that where the CLI is being used.

To use the License CLI, you will need to have registered on MyDelta and be assigned as a technical contact for your organisation.

Please see the Register for access to License Manager and License CLI section.

View Purchase information

You can use the “info” command to get detailed information about your purchases.

java -jar licensing-cli-1.0.0.jar info


Specifying a purchase after the info command will show you the line items on the purchase, including all of the information relevant to them such as license type, allowed usage, quantity, license expiry, and support expiry.


For most license types it will also display any System IDs alongside their size, Host ID, and the last time that they were edited. Each System ID is essentially a separate license, though it is possible to have more than one assigned to a single machine. If you are using ConcurrentOperation or RESTCapacity licenses then you will need to create a license server, please see How to setup a license server for more information. While it is possible to divide the number of operations on your order between a number of license servers (perhaps at different sites/locations), a common use-case would be to provision a server for all of the licenses that are specified in the line quantity.

Activate/Associate System ID with Host ID

Once you have created a system entry or have found the one you need to assign, you can use the following command to associate the license with a machine or individual. To do this you need the System ID, a long string of letters and numbers, and the Host ID, which could be a username, a server name, an IP address, or a mac address.

java -jar licensing.jar activate system-id [hostid]

The format of the Host ID changes depending on what the license is being assigned to. A prefix needs to be added to the username/hostname/ip you have been given - which might be USER=, HOSTNAME=, or INTERNET=. You can find out how in the How to determine a license server hostid section.

For example, the following command will associate the license with a machine called “server.eu.west”:

java -jar licensing-cli-1.0.0.jar activate 11122233-big-systemid-number-999 HOSTNAME=server.eu.west

Whereas this command will associate the license with a user called “oliver.partridge”:

java -jar licensing-cli-1.0.0.jar activate 11122233-big-systemid-number-999 USER=oliver.partridge

And finally, this command will associate the license with the given IP address:

java -jar licensing-cli-1.0.0.jar activate 11122233-big-systemid-number-999 INTERNET=1.2.3.4

Download License File

Finally, you can download the license file using the following command structure:

java -jar licensing.jar download system-id [filename]

For example, the following command will download the license for system “11122233-big-systemid-number-999“ and name it “oliverlicense.lic”:

java -jar licensing-cli-1.0.0.jar download 11122233-big-systemid-number-999 oliverlicense.lic

For convenience it is better to name the license file according to the user’s name, the machine, and/or the product so that you can tell it apart from other license files. The license file must also have the “.lic” file type if it is to work.

When the download command is used successfully, you will see a message that says something similar to the following:

New license being stored at: /example/filepath/oliverlicense.lic

You should then be able to find the .lic file in the indicated folder.

Licenses need to be installed in the same folder that contains the product’s jar file, and need to be renamed as appropriate for the product. Not that if a filename is not included in the download command, the default license name for the product will be used.

View System History


#content .code