Description

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 must be installed on your local computer to run Scenarios and generate your test data. It will also need to be updated occasionally with the latest version. Complete the following steps to successfully update GenRocket Runtime on your computer.


First Time User? Use the links below to run through the initial setup process for GenRocket: 

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


Step 1 - Download GenRocket Runtime 

  • Log into the GenRocket web platform.

  • Expand the Options Menu in the navigation bar.



  • Click Download Runtime. The version number you are downloading may not match the version in the screen shot.



Step 2 - Extract the GenRocket Runtime File

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


Complete the following steps in Windows File Explorer:

  • Navigate to your downloads folder: C:\Users\*User Name*\Downloads.


  • Right click on the GenRocket Runtime zip file (genrocket-#.#.#).

  • Select Extract All... to extract the file.


    Note: Make sure you don't extract the folder into itself like this: C:\Users\yourName\genrocket\genrocket.

To extract the file to your User Home Directory/Folder, complete these steps:

  • Click Browse... to select an extract folder.

  • Select your User Home Directory/Folder (usually C:\Users\*Your User Name*).



  • The default path will show the name of the zip file being extracted: genrocket-#.#.# (the #'s are digits).

  • To avoid additional work, remove genrocket-#.#.# from the extraction path.

  • Click Extract at the bottom of the pop-up window.


  • The extracted folder will appear as shown below.


    Note: Please note that the version number will be different from what is shown in the folder name below.

  • You will need to rename the folder to: genrocket.


Runtime File Extraction Troubleshooting

If you happen to extract the Runtime to the default location, you will end up with a directory system that looks like this:

  • genrocket/
    • genrocket-#.#.#/
      • bin
      • lib

To fix the problem, only move the sub genrocket directory containing the bin and lib folders into your home directory. Be certain to remove the version number from the end of the folder name. It will look like this once finished: 

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


Step 3 - Replace the Older GenRocket Runtime Folder 

  • Navigate to your home directory:
    • On Windows this is usually C:\Users\*Your Username*\

  • Delete the current "genrocket" folder. (Sometimes your folder might include the version number also "genrocket-#.#.#" (the #'s are digits))

  • Move the new genrocket folder from the extraction location (usually Downloads) to your home directory.



Step 4 - Run the "genrocket" Command in the Command Window

  • Open a new command prompt since, the Environment Variable values are modified.

    Note: If you do not know where you command prompt program is, use the Search Bar in the Windows Start Menu.

  • Type genrocket into the command prompt and press the Enter Key.



  • If you do not receive any errors, you are all set.


  • A default .genrocket folder will be created in your User Home Directory/Folder automatically (usually C:\Users\User Name\).