While there are several articles discussing proxy mode/offline license in detail this is intended to be a quick reference of the steps necessary to license a machine that's behind a firewall.
This article assumes you have either a working elasticcobol.properties license file or a new one with just your subscription id and email address in it.
Commands to be run are in italics/bold
- Copy HCILicensing.jar to the 'firewalled' machine.
(on the firewalled machine) java -jar HCILicensing.jar -p hcecblrts (expect an error here)
- (on the firewalled machine) java -jar HCILicensing.jar -x sendthisfile.txt
- Copy the file 'sendthisfile.txt' to a machine that is not behind a firewall
- (on the non firewalled machine) java -jar HCILicensing.jar -f sendthisfile.txt -p hcecblrts
- Copy the file 'sendthisfile.txt' to back to the 'firewalled' machine
- (on the firewalled machine) java -jar HCILicensing.jar -i sendthisfile.txt
To confirm the license is now good you can (on the firewalled machine) run java -jar HCILicensing.jar -p hcecblrts -l which will indicate the license was not checked, and when it will be. Example output:
License not checked against server
License Server Will Be Checked: 2016-04-12 17:51:45
Queued Transaction Count: 0
Note for computers that have internet access but must pass through a password protected proxy server, perhaps a router, you may need to specify additional Java JVM parameters to allow HCILicensing.jar to access the Heirloom Computing License server. Your network administrator can supply the proxyHost name or IP address, the proxyPort port number on the router, the proxyUser id and proxyPassword assigned to you or your organization. Place these on your command line,
java -Dhttps.proxyUser=ian -Dhttps.proxyPassword=ian -Dhttps.proxyHost=proxyhost
-Dhttps.proxyPort=808 -jar HCILicensing.jar -p hcecblrts -r