Description

You can use the GenRocket Runtime while connected to a secure network or offline. To use GenRocket Runtime offline, add an offline certificate to your .genrocket folder in your home directory. 


Note: You do not need to use an offline certificate if you are connected to the Internet in a non-secure/corporate environment. 


Note: If you run the GMUS on a restricted network server, a GMS Offline Certificate will need to be used to validate locally on your computer. Please see this article for more information: How to Download a GMUS Offline Certificate.


In This Article


Video Training

The following video can be used to see a quick preview of these steps as well:

How Does the Offline Certificate Work?

  • Each offline certificate is specific to a GenRocket Organization.
  • Each offline certificate lasts for 24 hours.
  • After 24 hours, you must download a new offline certificate and place it in your .genrocket directory.


Note: If you are a member of two GenRocket organizations, you must download an offline certificate for each organization.


How to Download the Offline Certificate

Step 1 - Confirm resource.home.directory Value

  • Within the Resources pane, confirm you have added a value to the resource.home.directory
  • This is required to use an offline certificate and should match the System Home Directory path (usually C:/Users/User Name).


  • Click the Edit (Pencil) icon if one has not been assigned. 



Step 2 - Download the Offline Certificate

  • Expand the Download drop-down menu within the Resources Pane and select Download Offline Certificate.

  • This file will be named like this: GR#######Certificate.grc. (The # symbol represents numbers within the file name.)


Step 3 - Place the Offline Certificate into your .genrocket Folder

  • Navigate to the directory where the offline certificate was downloaded. This will typically be your Downloads folder.

  • Right-click the file and choose Cut or Copy.


  • Navigate to and open your .genrocket folder. It can be found in your home directory (usually C:/Users/User Name).

  • Right-click and paste the certificate file into this directory.


  • The fill will appear as shown below in the .genrocket folder:


Step 4 - Verify offline certificate is working

  • Disconnect from the Internet on your local machine.
  • Open a CMD or Terminal Window and change the directory to the directory path of the Scenario.
  • Run the GenRocket Scenario using the command below.
    genrocket -r ScenarioName.grs


  • If the Scenario runs successfully, your certificate is set up correctly (See image below).


Troubleshooting

Error - Unable to validate license

Reason - Invalid Access Key


The following error will appear when the resource.home.directory does not match the system home directory. This error occurs because GenRocket is unable to validate that the user has a valid, enabled profile to use the offline certificate.


To fix this issue, complete these steps: 

  1. Update the Resource Home Directory (Step 1) to match the System Home Directory path.
  2. Download the Offline Certificate again.
  3. Repeat SSteps3 and 4 above.