Description

The GenRocket Runtime generates 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 update GenRocket Runtime on your Windows computer successfully.


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


In This Article

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


When should the GenRocket Runtime be updated?

  • Any time a new version of GenRocket Runtime is released.


When are the steps in this article not needed?

  • Any time the update does not include a new version of GenRocket Runtime.
  • In these instances, you can follow the steps here to update the appropriate Jar files.


How to Update GenRocket Runtime

Complete the steps below to update GenRocket Runtime on a Windows computer:
 

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 screenshot.



Step 2 - Extract the GenRocket Runtime File

Once the download is complete, 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).

  • Remove genrocket-#.#.# from the extraction path to avoid additional work.

  • 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 differ 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 sure 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.

Special Note about Copying/Pasting without Removing Old GenRocket Folder

Suppose the newly extracted genrocket folder is copied and pasted without removing the old one in your home directory. 

This can result in the genrocket folder having multiple instances of the same jar file(s) for different versions, which will cause unexpected errors when running Scenarios (see below). 



In that case, an additional command will be needed to remove all old, obsolete jar files from a Windows machine's directory. Use the genrocketcl command, as shown below: 



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

This command can be used to ensure everything has been set up correctly. If no errors happen, you should be good. 

  • Open a new command prompt.

    Note: If you need to know where your 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.