What is an Organization Resource?
Organization Resources are variables shared by all users throughout an organization, but whose values may differ for each user. They are available to all Projects and Project Versions within the organization and are added to GenRocket by the Organization Admin.
These resources are most often referenced by Receiver parameters and Generator parameters to avoid hard coding a value that may be specific to a particular user.
When should Organization Resources be used?
They should be configured by any user wanting to run a GenRocket Scenario and generate test data on their local machine.
How do organization resources work?
Organization Resources allow each user to enter their own directory path for shared resources. This makes it possible for any user within a given Organization to download a Scenario and run it on their local computer.
Each Organization Resource consists of the following:
- Resource Name - Shared by all users within the organization.
- Resource Value - Defined per user in the organization.
They can be viewed in the upper right corner of the Project Dashboard after the user logs into the GenRocket web platform. The Resource Value will appear as shown below when GenRocket is set up and used on a Linux/Mac computer.
Important: If GenRocket will be used on a computer running the Windows operating system, the drive will need to be included in the Resource Value. Please see the image below:
What Resources Need to be Configured Before a User can Run Scenarios?
This will depend on several factors including if the information will only be stored and accessed on the user's local machine, pulled from a database, or accessed/stored on a specific server. All added resources for the organization will appear here, but may not be necessary for every GenRocket user.
These resources must be configured to run a Scenario on a user's local machine regardless of what other resources have been added:
- resource.home.directory - Defines the home directory on your local computer. This resource is mandatory and is part of the license check. It must match the user's Home Directory. If it does not match, GenRocket Runtime will throw an exception.
- resource.output.directory - Defines the directory where generated files will be saved.
If additional Organization Resources are present and not needed by a user, then a N/A can be entered as the value. This will allow the user to configure their resources appropriately and download their my profile.grp for running Scenarios.
Connecting to Databases
GenRocket can connect to most databases with an available JDBC Driver. A few steps are required before GenRocket can query data from and populate tables within a database. The following steps must be completed:
Step 1: Download the Appropriate JDBC Driver for your Database
Note: This file will be different for each database. Some providers offer their own JDBC Driver, while others must be obtained from a 3rd party provider.
Step 2: Create a Database Connection Properties File
This file contains the necessary information for connecting to the actual database.
Step 3: Add and/or Update resource.jdbc.directory
This Resource is necessary for GenRocket to know the location of the Database Connection Properties File on your local computer. General users will only need to update this resource if it has already been added by the Organization Admin.
Note: For more information about each of these steps, please see this knowledge base article: How do I connect GenRocket Runtime to a Database.
You can use the GenRocket Runtime while connected to a secure network or offline. To use GenRocket Runtime offline, you will need to add an offline certificate to your .genrocket folder in your home directory.
- Each offline certificate is specific to a GenRocket Organization.
- Each offline certificate by default lasts for 24 hours.
- After 24 hours you will need to download a new offline certificate and place it in your .genrocket directory.
The duration can be changed or increased by reaching out to the GenRocket team with a valid reason. Some customers have 30 days while others have 90 days. When configured for a longer period of time, you will not have to update the certificate for the extended time period.
You do not need to use an offline certificate if you are connected to the Internet in a corporate environment that has been secured in another way.
Note: If you are a member of two GenRocket organizations you will need to download an offline certificate for each organization.
This certificate can be downloaded from the Resources Pane within the Project Dashboard when logged into the GenRocket web platform. Click on the Download menu and then click on Download Offline Certificate.
Note; For more information about using Offline Certificates, please see this knowledge base article: Using an Offline Certificate for Corporate Environments.
Resources Pane Options
The following options are available in the Resources Pane:
How Do I Change the Resource Value?
Click on the Edit (Pencil) icon for any resource in the Resources Pane to alter the value.
Enter the new value and click the Save button to save the change.
Note: When a Resource Value is altered, the my profile.prg file will need to be downloaded again and updated on the user's local machine. For more information, please see one of these articles: