Applies to ReadyAPI 2.3, last modified on April 25, 2018

LoadUI TestRunner runs load tests and exports results as configured. You use it to run ReadyAPI load tests from the command line.

You can start the runner from the command line or from the ReadyAPI user interface. The latter approach is useful, when you need to build the command line and check the settings. See below.

Tip: Besides automating runs of LoadUI tests, you can also automate runs of SoapUI and Secure tests.

Location

The runner is located in the <ReadyAPI>/bin directory. The file name is loadtestrunner.bat (Windows) or loadtestrunner.sh (Linux and macOS).

Licensing

The load test runner is installed along with ReadyAPI and uses the same modules. It does not require any special license as it uses the existing LoadUI license you have.

Loading Script Libraries

ReadyAPI checks the folder specified in the Script Library folder every 5 seconds. If you set the script library folder dynamically, you need to wait for it to be loaded to use it. To do this, add a delay to your script after you command it to load the script library:

project.scriptLibrary = project.getPropertyValue("dataPath")
Thread.sleep(12000)

Getting the Generated Command Line

  • After you specified the desired launch parameters in the dialog, click Launch to start the runner:

    LoadUI TestRunner Dialog

    You will see the test log:

    Test log window
  • After the run finishes, you can find the generated command line at the beginning of the test log:

    The command line in the test log

    Select text in the window and copy it to the clipboard.

See Also

Command-Line Arguments