The GenRocket Runtime is used to generate data on your local machine or server. It acts like an engine on your local machine and follows the instructions within the Scenario to generate the test data. 

The GenRocket Runtime will need to be installed on your local computer to run Scenarios and generate your test data. Complete the following steps to successfully download and install GenRocket Runtime.

HOccasionally, updates will need to be installed for the GenRocket Runtime. 

Downloading the Runtime 

Go to the options menu in the top navigation and click Download Runtime. Note, the version number you are downloading may not match the version in the screen shot. 

Extracting the Runtime

Once the download is complete you will need to extract the Runtime into your User Home Directory/Folder (usually C:\Users\*Your User Name*).

In file explorer:

  1. Navigate to your downloads folder
  2. Right click the genrocket runtime zip file
  3. Selected "Extract All..."
  4. Make sure you don't extract the folder into itself like this: C:\Users\yourName\genrocket\genrocket

Extract to your User Home Directory/Folder 

  1. Click the "Browse..." 
  2. Select your User Home Directory/Folder (usually C:\Users\*Your User Name*)
  3. Click Extract 
  4. If the extracted folder has version number, rename the folder from "genrocket-#.#.#" (the #'s are digits) to "genrocket"

Note if you extract the Runtime to the default location you will end up with a directory system that looks like this:

  • genrocket/
    • genrocket/
      • bin
      • lib

Only move the sub genrocket directory which is containing bin and lib folders into your home directory so it looks like this: 

  • *Your Home Directory*/ 
    • genrocket/
      • bin
      • lib

Updating your Environment Variables

In the start menu:

1. Click on the Windows icon. 

2. Type "environment" in the search bar

3. Select "Environment Variables"

4. In the user variable section click "New..."

5. Add the first variable

  • Value: The value is the location path of the GenRocket RunTime. 
    • Example:  C:\Users\yourName\genrocket
  • Click "OK"

6. Add the second variable

  • Name: PATH
  • Value: %GEN_ROCKET_HOME%\bin
  • Click OK. 
  • NOTE: If you already have a PATH variable just add the %GEN_ROCKET_HOME%\bin to the end of it. Make sure to put a comma after the last value before you input before you add your value. 
    • Example:  C:\Some Other Path,%GEN_Rocket_Home\bin  

7. Click OK on the Environment Variables dialog and System properties dialog to save

8. Open a new command prompt since, the Environment Variable values are modified and type genrocket 

  • If you do not know where you command prompt program is, use the search box in the Windows Start Menu.
  • If you don't receive any errors, you are all set.
  • A default .genrocket folder will be created in your User Home Directory/Folder automatically

Troubleshooting Errors

  • If you receive an error when running the GenRocket Command.
    • Type echo %PATH% into your command prompt to make sure it your GenRocket value is listed.
    • Double check that the value of your variables are correct.
    • Visit this link if you need more help Setting up Windows Environment Variables.