Command line license utility

The Licensing command line interface is used to manage licenses for your customers:

You can download the latest copy of the utility for jdk8 here: https://downloads.heirloomcomputing.com/licensing/HCILicensing.jar

a jdk17 version is available here https://downloads.heirloomcomputing.com/licensing/17/latest/HCILicensing.jar

Command Line Interface Operation

You need a Java Runtime Environment (JRE) installed to operate the command line interface.  Download a JRE 1.8 or higher from http://java.com/ .  

Use the java command with the -jar flag to reference the command line java archive, followed by the options you require.  For example, to get command-line help, issue:

java -jar HCILicensing.jar -h

Heirloom Computing, Inc. Licensing-as-a-Service
Cloud Based License and Transaction System

Usage: java HCILicensing [-f licensing.properties]
   [-u https://.../licensecheck]
   [-s subscription-id] [-e email-address]
   [-c transaction-count]
   [-i import-file] [-x export-file]
   [-p product-code] [-r] [-q] [-l] [-h]
   -f -- licensing properties file containing license checking info, default
         'licensing.properties' in your home directory
   -u -- license / transaction checking URL, default
      'https://paas.heirloomcomputing.com/rest/2018-01-01/licensecheck'
   -s -- subscription-id to check against, replacing or
      initializing licensing properties file
   -d -- licensing domain name, default contained in licensing properties file
   -e -- email-address authentication to check against, replacing or
      initializing licensing properties file
   -p -- product-code to check, default taken from or added to
      licensing properties file
   -c -- add transaction count to total, default 1
   -x -- export the current license file
   -i -- import the given file and merge it with the current license file
   -r -- require a check against the LaaS server
   -l -- list the current counts, when to check the license again,
      remaining grace period
   -q -- quiet, do not print anything
   -h -- this list of options
   exit code 0 if OK, 1 if expired but within grace period, 2 if expired
   outside grace period, or 100 communications problem
(c) 2013 Heirloom Computing Inc., http://www.heirloomcomputing.com/

 

Assuming you have a valid format license file on the machine you can use the utility to check the license and force a license request if needed.

The following product codes can be used, one per command line in the following examples:

Eclipse IDE: hpaas-cbl-sdk
RTS:hpaas-cbl-rts
Elastic Batch Platform:hpaas-ebp-rts
PLI Compiler: hceplicmp
PLI Runtime: hceplirts

The examples below assume the license file is in the default location. If you have moved the license file you can use the -f flag, or set the java variable heirloom.license to the correct location, like this:

java -Dheirloom.licensefile=<location> -jar HCILicensing.jar ..

Verifying a License

You can verify whether a license is currently up-to-date  without necessarily checking it with the license server.  Issue

java -jar HCILicensing.jar -l -p hcjes

to generate a report on the status of the Elastic Batch Platform license:

Heirloom Computing, Inc. Licensing-as-a-Service
Cloud Based License and Transaction System

License not checked against server
   Product: hcjes
   License Server Will Be Checked: 2014-02-20 23:03:59
   Grace Period: 29days 23hours 48minutes
   Queued Transaction Count: 0

If the license shows that it will next be checked at a later date, or if it has a grace period then the license is valid. Your license grace period is controlled by the license server and can be modified there, along with the number of cores, expiry date etc.

If you have license issues you should use the -l command for each product on the machine and include the output in any tickets you raise with support. You should also include the license file as an attachment on those tickets (there is no confidential information in the elasticcobol.properties file).

Forcing a license check

Regardless of if a license is still within the "grace period" you can require that the HCILicensing command verify it against the license server.  Issue

java -jar HCILicensing.jar -r -p hcjes

The -r option will force the license to be checked and will update the cores,grace period and expiry date accordingly.

Client machines behind true Proxy Servers

Proxy Checker (supporting systems without internet access)