Share this page

# JMeter tests

This topic describes how to use JMeter scripts in performance tests.

In this topic:

## JMeter tests overview

JMeter is an open-source load testing tool for analyzing and measuring the performance of a variety of services, with a focus on web applications.

By including JMeter (.jmx) scripts in your tests, you can run one or more JMeter tests side-by-side with any other tests, giving you a single entry point for running your performance tests.

Measurements can be viewed in online and offline graphs and Analysis, using the data points from the JMeter tests.

JMeter scripts can be run on a load generator on a Windows or Linux operating system. The Docker installations of Windows and Linux also support JMeter scripts.

Back to top

## Transactions in JMeter scripts

JMeter tests work with threads, JMeter's equivalent of Vusers, and thread groups. JMeter tests are handled as follows:

- If your JMeter script contains multiple thread groups, only the first group is run. If you want all groups to be run, you need to perform the following:

  1. Re-upload the script (the script is automatically split into multiple scripts).

  2. Update all of your JMeter tests with the new scripts.

- Only transaction names under the TransactionController section in the .jmx file are shown in the results.

- Transaction names must not include a dot.

Back to top

## Prerequisites

Follow these guidelines before creating a performance test with a JMeter script.

Area | Details
--- | ---
Installation requirements | An embedded version of JMeter is included in the installation. No other installation or configuration is necessary. Download and install a supported JDK version on all load generator machines upon which the scripts are run. For supported JDK versions, see the Supported Protocols guide available from Support Matrix.
Load generator setup | Java setting for Windows: Check that the environment variable %PATH% includes the directory of jvm.dll (for example: %JAVA_HOME%/jdk/jre/bin/server). Java setting for Linux: Check that the environment variable $LD_LIBRARY_PATH includes the directory of libjvm.so. We recommend setting the JAVA_HOME environment variable to point to the Java JDK folder.
Performance Engineering Agent settings | If the agent is set as Service, change the System environment variables JAVA_HOME and PATH, and restart the load generator machine. If the agent is set as Process, change any User or System environment variables JAVA_HOME and PATH, and restart the agent.
Data files | The JMeter script can reference parameter files in .csv format. To reference .csv files, make sure that: They are in the same folder (and not a subfolder) as the .jmx file. The reference path in the JMeter script correctly points to the .csv files. The Controller finds these files, and sends them to the load generator for the test run. Tip: To show the contents of JMeter script .csv files in the Script Details tab, you need to edit the configuration file. Edit the appsettings.defaults.json file to include the .csv extension both locally and in the LRE_CONFIGURATION_SERVICE folder so that the customization will be retained after an upgrade: Copy code
    "ScriptConfiguration": {
        "IncludeFiles": [
          ".cs",
          ...
          ".csv"
        ],
Creating JMeter scripts | Create scripts in JMeter and save the scripts locally. The scripts must be saved in ZIP format and must include all the files in the test scripts folder. Add any external .jar files dependencies to the <InstallDir>\bin\jmeter\lib folder. Add any plug-ins used in the JMeter script to the <InstallDir>\bin\jmeter\lib\ext folder because they must be added to the embedded JMeter as well. The file path inside a script folder must not exceed 260 characters.

Back to top

## Set up and run a JMeter test

This task describes how to upload JMeter scripts to a test and configure runtime settings.

1. Make sure that you follow the prerequisites for using JMeter scripts.

   For details, see Prerequisites.

2. Upload JMeter scripts to OpenText Enterprise Performance Engineering.

   For details, see Upload a script.

   Note: When uploading a JMeter script, you can split a .jmx file that contains a number of JMeter groups into a separate .jmx file for each group.

   After uploading the script, it is added to the test management tree. You can view and edit most scripts directly from within the user interface. For details, see Edit a script.

3. Create a performance test, and assign the JMeter script to it.

   For details, see Tests.

4. Configure JMeter runtime settings.

   If you need to specify a custom JDK path, or parameters, for example, if you want to change the behavior of the JVM, you need to configure the runtime settings.

   1. After you have uploaded a JMeter script and added it to a test, select the test in the test management tree and click Edit Test.

   2. In the Groups and Workload view, select a Vuser group and click the Edit Runtime Settings button . The JMeter Runtime Settings dialog box opens.

   3. In the JMeter Runtime Settings dialog box, select:

      - Use default JRE path to use the default JRE installation to run JMeter tests. The path, registry, and Windows directory are searched to locate the JRE to be used.

      - Custom JRE path to use a custom JRE installation. Enter the path to the JRE folder and any additional parameters to be passed to Java when the test starts in the Additional parameters box.

5. Run the test.

   For details, see Manage a performance test run.

   Data points from JMeter tests are displayed in the graphs. For details, see View JMeter test results.

Back to top

## View JMeter test results

You can monitor JMeter test results using the following standard graphs:

- Running Vusers

- Transaction Response Time

- Total Transaction per second (Passed)

- Transactions per second (Passed)

- HTTP Responses per second

- Hits per Second

- Throughput - Whole Load Test

For graph details, see Web resource monitor graphs, Runtime monitor graphs, and Transaction monitor graphs.

Back to top

## Notes and limitations

The following are notes and limitations when working with JMeter scripts:

- JMeter scripts that use Web HTTP requests only are supported.

- OpenText Network Virtualization is not supported for JMeter tests.

Back to top

See also:

- Assets
- Tests

https://admhelp.microfocus.com Enterprise Performance Engineering,LoadRunner Enterprise 8942
Tips to improve your search results...OpenText™ Enterprise Performance Engineering Help Center OpenText™ Enterprise Performance Engineering Help 26.1 All View Local Help Center View Online Help Center Version: