Introducing the License CLI

The License CLI tool has been created to allow customers to easily manage their licenses directly from the host machine. It is also appropriate for customers who have large or complex configurations and wish to automate their licensing operations through scripting. Here are a few of the key functions, for more detailed information about License CLI procedures please view the Licence Manager & CLI Procedures section.

Unleash the power of the CLI

Managing your licenses with the License CLI removes some steps in the usual processes making the procedures quicker and less prone to error. Where you need to download several licenses this can be done using the License CLI on each machine removing the need to rename files twice as you download and move them. Another example is setting the HostId which can take time to identify and cut and paste into the License Manager, where as the License CLI simply uses the HostId of the server by default.

Automated Processes

The most powerful aspect of the new CLI is the ability to automate licence renewals, using CRON or other such tools renewal of the licence file can be completed automatically. This means you can remove any manual processes to ensure your DeltaXML software will always run without interruption.

View your licenses

The License CLI can list your purchased products using the info command, after which you can activate systems using the System Ids displayed previously to obtain a license.

Some customers may find no purchases returned, don’t worry they are there, your registered email may be different to the one we have or you may simply not be associated with the purchase in our database. Please just follow the onscreen instructions and you will have access shortly after.

Using the System Id the history command will provide a list of chronological log of actions such as activations and deactivations on that system.

Here is a short example showing a purchase and the associated systemIds:

$ java -jar licensing-cli-1.0.1.jar info
Purchase: DelCo Software 10001                                      Customer: DelCo Software                 Support Expiry: 2022-01-01 lines:  3
    -------|----------------------|-----------------|-----------------|-----|-------------|------------
    Line # | Product              | License Type    | License Use     | Qty | license exp | support exp
    -------|----------------------|-----------------|-----------------|-----|-------------|------------
    1      | XML Compare Java     | Server 2 Cores  | PRODUCTION      | 3   | 2022-01-01  | 2022-01-01 
        -------------------------------------+------+------------------------------------------+------------
        System Id                            | Size | Current HostId                           | Last Modify
        -------------------------------------+------+------------------------------------------+------------
        a2a50834-ccd9-4b57-b5d2-39a9dc8d1db1 | 1    | Hostname=prod2.eu.newco.com              | 2021-04-29T17:10:04.826159Z
        d9fcba70-2875-4075-bc2a-110c88c53199 | 1    | Hostname=uat1.us.newco.com               | 2021-04-29T17:10:41.817731Z
        c5d36e3c-b8c7-4e75-8d0a-a56841d8ec61 | 1    | Hostname=prod1.us.newco.com              | 2021-04-29T17:11:15.878546Z
    -------|----------------------|-----------------|-----------------|-----|-------------|------------
    Line # | Product              | License Type    | License Use     | Qty | license exp | support exp
    -------|----------------------|-----------------|-----------------|-----|-------------|------------
    2      | XML Merge Java       | Concurrent Oper | PRODUCTION      | 8   | 2022-01-01  | 2022-01-01 

When no argument is provided the usage message provides a reminder of the commands and their arguments:

$ java -jar licensing-cli-1.0.1.jar
Usage:
  java -jar licensing-cli-1.0.1.jar auth
  java -jar licensing-cli-1.0.1.jar info [purchase [line]]
  java -jar licensing-cli-1.0.1.jar activate system-id [hostid [port]]
  java -jar licensing-cli-1.0.1.jar download system-id [filename]
  java -jar licensing-cli-1.0.1.jar deactivate system-id
  java -jar licensing-cli-1.0.1.jar history system-id
  java -jar licensing-cli-1.0.1.jar create-system purchase line
  java -jar licensing-cli-1.0.1.jar delete-system system-id
  java -jar licensing-cli-1.0.1.jar redist purchase line



#content .code