GenRocket Installation 

Requirements for Installation 

1. Use a Supported Operating System and Browsers

  • Supported Operating Systems: Generally Windows, Linux, and macOS -- but GenRocket can support most OS that support Java
  • Supported Browsers: Chrome, Firefox, and Safari


2. Recommended Hardware Requirements for GenRocket Runtime

GenRocket is able to run on nearly any machine that supports Java. For an optimal experience we recommend your machine has:

  • 4 Core CPU 
  • 8GB RAM


3. Install a Minimum of Java 1.7 (JRE)

Your computers must have at minimum Java 7 installed to run GenRocket. You can verify your version of Java at this site. 

  • GenRocket does not support following versions of Java:
    • Java 1.8 u20 
    • Java 1.9+


Note: Some of the Generators take memory to maintain the uniqueness of random data that is being generated, therefore along with JAVA_HOME environment variable also, set JAVA_OPTS environment variable.


For Windows users, set JAVA_OPTS to -Xms512m -Xmx2048m -XX:-UseGCOverheadLimit

For Linux/Mac users, set JAVA_OPTS to -Xms512m -Xmx2048m -XX:PermSize=512m -XX:MaxPermSize=2048m


4. Don’t Install the GenRocket Runtime on a Secure Drive or Virtual Drive

Because of security setting implemented by companies GenRocket may not run on secure drives. Please make sure your team installs GenRocket on their unsecure drive (usually the C:\ drive.)


5. Verify you have access to app.genrocket.com

If you are unable to access app.genrocket.com from your corporate machine you will need to send a request to your IT department to allow https access to this site. 


6. Hosting Options

If you have purchased GenRocket licenses you will need to select a hosting option - Cloud, Private Cloud, or On-premise. The majority of GenRocket proof of concepts are hosted on our cloud environment. If you are interested in an on-premise installation please contact info@genrocket.com.


7. Install Groovy 2.0+ (only required for GenRocket API usage)

If you are going to leverage the GenRocket API you will need to install Groovy. If you do not plan to use the GenRocket API, you do not need to install Groovy. You can install Groovy from this link


GenRocket Runtime and Profile Installation: 

Follow the below links to learn how to install the GenRocket Runtime and Profile. You can also learn how to install GenRocket by completing the Setup Tutorials on the Tutorial Dashboard.


Installation for Secure Environments

You can use GenRocket in a secure network or offline with one additional step - by adding an offline certificate to your .genrocket folder in your home directory. You do not need to use an offline certificate if you are connected to the internet in a non-secure/corporate environment. Please view this help article for a detailed description of how to download the certificate. 


Database Specifics

GenRocket can directly connect to any database that supports JDBC. To learn how to connect GenRocket to your database place refer to this help article


Validating Installation 

If you believe the above requirements are met you can verify everything is working by completing the following training in the GenRocket Tutorial Dashboard. You will see these lessons when you first login into GenRocket. 

  • Basic Training (Lessons 1-8): Completing this training will expose any changes you need to make on your corporate environment to allow GenRocket to work. This will take less than 30 minutes.