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
- How Does the Offline Certificate Work?
- How to Download the Offline Certificate
- Troubleshooting
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.
- Enter the directory path as the value and click Save.
Note: This must match your system home directory path (usually C:/Users/User Name).
Note: If this value changes, you must also download your profile file. See one of these pages for more information:
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:
- Update the Resource Home Directory (Step 1) to match the System Home Directory path.
- Download the Offline Certificate again.
- Repeat SSteps3 and 4 above.