Install LoadUI agent Application

Applies to ReadyAPI 3.53, last modified on June 26, 2024


To install the LoadUI agent application:

  1. Download the installer from the SmartBear website, copy it to the remote computer and run it.

  2. Follow the instructions of the installation wizard.

After the installation is complete, open the installation directory (for example, Program Files\SmartBear\LoadUIAgent-3.53.0\bin in Windows) and start the agent. The LoadUI agent application must be running for ReadyAPI to run tests on this Agent.

It is possible to install the LoadUI agent on the computer where ReadyAPI is already installed to use it as one of the agents during the distributed load test.

For information on how to install the LoadUI agent using the command line, see Installing LoadUI agent Using Command Line (Console).


Adjust the available memory

By default, ReadyAPI LoadUI agent uses up to 4 gigabytes of memory on 64-bit systems and 900 megabytes on 32-bit systems.

To avoid issues on low-end systems, the agent uses a half of the available memory if your computer has less than 8Gb of RAM (or 1.5 Gb on 32-bit systems).

To provide access to more RAM for large load tests:

  • If you use the loaduiagent batch file (.bat or .sh), open it in any text editor and find the comment LOADUI_AGENT_RAM_LIMIT parameter. Uncomment it and set the limit you need.

  • If you use the LoadUIAgent-3.53.0 executable, open the LoadUIAgent-3.53.0.vmoptions file and set the –Xmx value.

32-bit operating systems cannot allocate more than 1.5 gigabytes of memory for one application. We do not recommend specifying an allocation pool greater than 1Gb on such computers. If your tests require more memory than 1 Gb, use several agents, a 64-bit OS or move your tests to the cloud.
Change the agent settings

Agents run load tests in the same way as the tests are run on the local computer. To modify the settings of the agent, copy the readyapi-settings.xml file to the user folder on the agent computer. This file is stored in the <User directory>/.readyapi folder on any computer that has ReadyAPI installed.

To modify the maximum number of threads on the computer, change the <con:setting id="UISettings@maxThreads">1000</con:setting> value.

If the maximum number of threads is specified both in the readyapi-settings.xml file and in ReadyAPI settings, the agent will always choose the minimum value between the two.

See Also

Installing LoadUI agent Using Command Line (Console)
Configuring Network Access and Proxy

Highlight search results