Description

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


In this article, we will install GenRocket Runtime on a remote server via SSH. We are using an Ubuntu server, but the steps will be similar in any Linux distros.


In This Article


Step 1 - Install Java Runtime

Java is necessary to run GenRocket Runtime on your server for generating test data. Your server must have, at minimum, Java 8 installed to run GenRocket Runtime. GenRocket does not support the following versions of Java:

  • Java 1.8 u20
     

Note: Click here to see a complete list of supported Java Versions.


To install java, first update the package index:

sudo apt update


Next, check if Java is already installed:

java -version


If Java is not currently installed, you’ll see the following output:


Execute the following command to install OpenJDK:

sudo apt install openjdk-8-jre-headless


This command will install the Java Runtime Environment (JRE). Verify the installation with:

java -version


Step 2 - Download GenRocket Runtime on your local machine and copy it to the remote server

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.


Copy the downloaded zip file to the remote machine

scp ssh '/path/to/your/download/genrocket-x.x.x.zip' user@remoteip:/home/directory


Step 3 - Unzip and Rename the GenRocket Runtime on your remote machine


Install unzip to unzip the files

sudo apt-get install unzip

Unzip GenRocket in your home directoryls

unzip genrocket-x.x.x.zip

This will extract genrocket in your home directory


Step 4 - Rename GenRocket folder to remove the version number


Enter the following command

mv genrocket-x.x.x genrocket

This will rename the genrocket folder. Verify the folder name.


Step 5 - Update bashrc


Update .bashrc using your favorite text editor 

nano .bashrc


Add the following lines:

export GEN_ROCKET_HOME=~/genrocket
export PATH=$PATH:$GEN_ROCKET_HOME/bin


Save and exit by pressing Ctrl+x and Y


Reload .bashrc by using the following command: 

source ~/.bashrc

Step 6 - Verify GenRocket installation and download GenRocket Jars

You can download the GenRocket jars and verify the installation by entering

genrocket