To get started with GenRocket, you will need to complete a few basic installation and setup steps. These steps typically only need to be completed once for first-time users, with the exception of occasional GenRocket Runtime updates, and include the following:
- Download GenRocket Runtime
- Extract the GenRocket Runtime File
- Modify the Shell Startup File
- Run the "genrocket" Command in your Terminal Window
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.
Need to Update GenRocket Runtime Only? Please see one of the following articles:
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 - Unzip and Rename the GenRocket Runtime File
The GenRocket Runtime file will need to be extracted, renamed, and moved to your home directory.
Note: The images below show how to perform these steps for Mac OSX. Some steps might vary if you are using the Linux operating system.
Complete the following steps:
- Navigate to the directory where the file was downloaded. This is usually your downloads folder.
- Right click on the file and click Open to extract it automatically.
Note: If you use a specific extraction program, you may need to select the Open With option and then click on the appropriate application.
- When extracted, the folder name will appear like this: genrocket-#.#.# (the #'s are digits) and will need to be renamed.
- Rename the folder to genrocket.
- Right click on the folder name and choose Rename.
- Remove "-#.#.#" from the folder name.
- It will appear as shown below once renamed:
- Move the genrocket folder to your home directory. For Mac OSX, this is typically: Users\User Name. This may vary per computer and operating system.
- Right click on the genrocket folder and then click on Copy "genrocket".
- Navigate to your home directory. For Mac OSX, use this shortcut key combination when viewing your files: CMD+SHIFT+H.
- Right click and click Paste Item to paste the folder into your home directory.
Note: Once the file has been placed in your home directory, steps will need to be taken to finish the install based on your specific operating system. See below to learn more about installing GenRocket Runtime on your specific operating system.
Step 3 - Installing on OSX/Linux
To complete the install, you will need edit your shell's startup file. This is typically .bashrc, .profile, or .bash_profile in your home directory. Add the following lines:
export GEN_ROCKET_HOME=~/YourPath/genrocket export PATH=$PATH:$GEN_ROCKET_HOME/bin
If you will be running Java 1.9+, then an additional command may be necessary for this setup:
export JAVA_OPTS=-Xms512m -Xmx2048m --add-opens java.base/jdk.internal.loader=ALL-UNNAMED --add-opens jdk.zipfs/jdk.nio.zipfs=ALL-UNNAMED
Example for Mac OSX:
- Open the shell startup file through your terminal window. This is typically bash.profile.
- Enter this command to open your .bash_profile:
- Enter these lines into your shell start-up file.
export GEN_ROCKET_HOME=~/genrocket export PATH=$PATH:$GEN_ROCKET_HOME/bin export JAVA_OPTS=-Xms512m -Xmx2048m --add-opens java.base/jdk.internal.loader=ALL-UNNAMED --add-opens jdk.zipfs/jdk.nio.zipfs=ALL-UNNAMED
Since the default is the home directory on a Mac, the first line will need to be entered like this: export GEN_ROCKET_HOME=~/genrocket.
Please note that the first line should point to your path and this may vary per computer.
To exit this screen, press Control + X.
Enter Y to save the change.
Then press the Enter Key to finish.
You will be returned to the terminal window.
Step 4 - Run the "genrocket" command in Terminal Window
By putting $GEN_ROCKET_HOME/bin on the path, you will be able to execute the shell script for completing the install from any location.
- Open a new terminal session and type genrocket on the command line.
- Press the Enter Key.
Note: If you do not receive any errors, you are all set.