Follow

Quick reference for machines without internet access

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

 

  1. Copy HCILicensing.jar to the 'firewalled' machine.
  2. (on the firewalled machine) java -jar HCILicensing.jar -p hcecblrts (expect an error here)

  3. (on the firewalled machine) java -jar HCILicensing.jar -x sendthisfile.txt
  4. Copy the file 'sendthisfile.txt' to a machine that is not behind a firewall
  5. (on the non firewalled machine) java -jar HCILicensing.jar -f sendthisfile.txt -p hcecblrts 
  6. Copy the file 'sendthisfile.txt' to back to the 'firewalled' machine
  7. (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
Product: hcecblrts
License Server Will Be Checked: 2016-04-12 17:51:45
Queued Transaction Count: 0



Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

1 Comments

  • 0
    Avatar
    Don

    Could our license need to be reset?
    I may have done these steps too many times, and/or fumbled some previous attempts.
    Here is what occurs when trying to follow the steps in:
             https://support.heirloom.cc/hc/en-us/articles/212579346-Quick-reference-for-machines-without-internet-access

    The first two HCILicensing steps on the firewalled machine result in the following.
    The above site says to expect an error on the first step.

    $ java -jar HCILicensing.jar -p hcecblrtsdep
    HCI906E Unable to verify your Heirloom Computing subscription at https://paas.heirloomcomputing.com/rest/2015-02-01/licensecheck - communication error 'connect timed out'
    $ java -jar HCILicensing.jar -x sendthisfile.txt
    License Export is OK

    This is what occurs on the non-firewalled machine. I think this error is unexpected.
    The sendthisfile.txt file does not get modified in any way by this step.

    W:\work2>java -jar HCILicensing.jar -f sendthisfile.txt -p hcecblrtsdep
    HCI902E Failed checking Heirloom Computing subscription (Error 07).
    Unable to verify the identity of this system (00-50-56-A2-34-8F) because of a mi
    ssing signature.
    You may have restored your license properties file or it is not writable.
    Request a license reset at <a href="https://www.elasticcobol.com/index.php/suppo
    rt">Support</a>.

    Check <a href="https://heirloomcomputing.zendesk.com/entries/24970493-Licensing-
    Error-Messages#ERROR07">here</a> for more information about licensing errors

    This is the result of the step #7 of the above site:

    $ java -jar HCILicensing.jar -i sendthisfile.txt
    License Import is OK

    This is the result of the verification step.
    $ java -jar HCILicensing.jar -p hcecblrtsdep -l
    Heirloom Computing, Inc. Licensing-as-a-Service
    Cloud Based License and Transaction System

    License not checked against server
    Product: hcecblrtsdep
    License Server Check Past Due: 2017-03-11 15:42:17

    This is an attempt to run an ecobol program.

    $java -cp /workspace/ecobol/runtime/ecobol.jar:/workspace/ecobol/ecobol_project-save/.executable filetest
    Elastic COBOL Runtime Error: HCI906E Unable to verify your Heirloom Computing subscription at https://paas.heirloomcomputing.com/rest/2015-02-01/licensecheck - communication error 'connect timed out'
    Exception in thread "main" java.lang.ExceptionInInitializerError
    Caused by: java.lang.RuntimeException: HCI906E Unable to verify your Heirloom Computing subscription at https://paas.heirloomcomputing.com/rest/2015-02-01/licensecheck - communication error 'connect timed out'
    at com.heirloomcomputing.ecs.exec.Variable.completeInitialization(Variable.java:20562)
    at filetest.<clinit>(filetest.java:46)

     

     

Please sign in to leave a comment.
Powered by Zendesk