Install an on-premises load generator on Windows

Use StormRunner Load (SRL) load generators to run load tests on-premises on applications that cannot be accessed from over your firewall.

Caution: Installing the on-premises load generator package on a machine that is running any Micro Focus performance or functional products is not supported.

Prerequisites

  • Before installing an on-premises load generator, ensure that .NET version 3.5 is installed on the load generator machine.

    Note: Some versions of Windows require you to manually enable and install .NET version 3.5.

  • To help ensure the successful installation of an on-premises load generator, enable Windows Script Host on the load generator machine.

Back to top

System requirements

Memory, CPU, and free disk space requirements vary per protocol, system under test and script characteristics.

The recommended system requirements are:

Recommended OS

The following OS are recommended:

  • Windows 2012 R2

  • Windows 2008 R2

Note:

  • Verify that Windows update package KB2999226-x64 has been applied.

  • Only English OS version is supported.

Supported OS Windows 7 (64 bit) and above
CPU 8
Memory 16GB
Free disk space

32GB

Note: During installation, the installer checks for space in the temp directory, as configured in the user’s local environment variables.

Recommended Bandwidth A bandwidth of at least 1Gbs is recommended for communicating with the StormRunner Load servers.

Back to top

Notes and limitations

Limitation/Note Solution
Date and time

Ensure that the date and time on the load generator machine are correct.

Tip: Synchronize your computer clock with an Internet time server.

Connection between LGs and StormRunner Load

The load generator machine needs to be able to access the StormRunner Load servers in SaaS and the cloud machines. (Only outbound HTTPS connection on port 443 needs to be enabled.)

If there is no connection between StormRunner Load servers and the Load Generator (on-premises load generator Status=Not Connected), an error message is reported when you try to run your test.

One test per load generator

The load generator can run only one test at a time. If the required load generator is already in use by another test, an error message is reported when you try to run your test.

Vusers

Vusers in your on-premises load test cannot exceed the maximum number of Vusers in your license.

Security Ensure that the OS, as well as any protocol prerequisites (for example, JDK and .NET), have the latest security updates.
Multiple IP addresses

If you have requested multiple IP addresses for a load test, you must ensure that you have assigned all the valid IP addresses to the load generator machine so that StormRunner Load can use them during the test.

For details on working with multiple IP addresses, see Enable multiple IP addresses.

Back to top

Set up an on-premises load generator

Note: If you are updating the load generator, see the instructions for installing the update below.

Action How to
Define your load generator in StormRunner Load and note the key:
  1. In StormRunner Load, select Assets > Load Generators.
  2. Select the load generator from the list, or click Create to add one. Give the load generator a meaningful name and description.

  3. Select the relevant operating system.

  4. Set the maximum number of Vusers for each supported protocol. Default values are displayed.

  5. Click Save.

  6. A key is generated for the load generator and is displayed in the details on the right. Note the load generator's key for later use.

Download the load generator installation package

On each machine on which you want to install a load generator, download the installation .zip file from StormRunner Load Home page > Get tools > Agents > Get OPLG, and extract the contents.

Note:

  • Before installing an on-premises load generator, ensure that .NET version 3.5 or later is installed on the load generator machine.
  • To help ensure the successful installation of an on-premises load generator, enable Windows Script Host on the load generator machine.
Install the load generator components
  1. Run the extracted file StormRunnerLoadGenerator.exe. The installer Welcome page opens.

    Tip: We recommend that you run the installation as an administrator.

  2. Accept the license agreement.

  3. By default, the load generator is installed in c:\stormrunnerlg. To install it in a different folder, click Options, change the path, and click OK.
  4. Click Install to start the installation of the load generator, and other required applications.

    When the installation is complete, the StormRunner Load load generator configuration tool opens.

    To skip the configuration at this point, close the tool and configure it later.

    Note: The load generator and the StormRunner Load server will be able to communicate only after the load generator is properly configured.

Configure the load generator
  1. On the General tab, enter:

    • The load generator key that your noted earlier.
    • Your StormRunner Load user name and password
    • Your Tenant ID.
  2. On the Misc tab:

    • To use a different proxy other than the one shown, enter your proxy URL.

      If your proxy requires authentication, select the Advanced tab to enter your credentials.

      Note: This is necessary only if the Load Generator machine cannot directly access the internet.

    • Select a Log level.
  3. Click Save & Test to save your settings and test your connection to the StormRunner Load server.

    Tip: If you get an error, check that the configuration details that you provided are correct.

For more information on configuring the load generator, see On-premises load generator configuration tool.

Launch the load generator

Go to Start > StormRunner Load Generator > Start SRL Generator.

Tip: We recommend that you run the load generator as an administrator.

Back to top

Install an on-premises load generator update

On each machine where you have a load generator installed:

Action How to
Download the load generator upgrade package

Download the upgrade zip file from StormRunner Load Home page > Get tools > Agents > Get Upgrade Package and extract the contents.

Upgrade the load generator
  1. Stop the load generator you want to upgrade.
  2. Run the extracted file SRLUpgradePatch.exe. The upgrade installer Welcome page opens.

    Tip: We recommend that you run the installation as an administrator.

  3. Accept the license agreement.

  4. Click Install to start the upgrade.

    As part of the upgrade, the existing load generator configuration settings are retained.

    When the upgrade is complete, the StormRunner Load Generator Configuration tool opens. To skip the load generator configuration at this point, close the tool.

    Note: The load generator and the StormRunner Load server are able to communicate only after the load generator is properly configured.

    For more information on configuring the load generator, see On-premises load generator configuration tool.

Note: After upgrading a load generator, the desktop icons for configuring and starting the load generator are no longer visible and you need to create new shortcuts.

Back to top

Access the Load Generator Configuration tool

If you skipped the load generator configuration when you installed or updated the on-premises load generator, or if you need to update the configuration settings:

Go to Start > StormRunner Load Generator > Configure Load Generator.

Back to top

Enable multiple IP addresses on an on-premises load generator

You can configure a load test to use multiple IP addresses on an on-premises load generator.

Action How to
Enable multiple IP addresses in StormRunner Load Contact your account manager or sales representative.
Enable multiple IP addresses for a load test From StormRunner > Load Tests > General tab, select the Enable multiple IP addresses check box.
Allocate sufficient IP addresses

You must ensure that you have allocated the required number of valid IP addresses on the relevant on-premises load generator.

For more information, see Enable multiple IP addresses.

Back to top

Run a test using an on-premises load generator

Action How to
Create a test

From StormRunner > Load Tests, select a load test or create a new test.

Select On-premise as the location of the load generators

From the Scripts tab, select a script and then select On-Premise from the Location drop-down list.

Add a load generator

From the Distribution tab, click On Premise and then click Add from Assets to select the on-premises StormRunner Load Generators to use for your test.

For more information, see Manage load tests.

Back to top

Uninstall an on-premises load generator

From the Control Panel:

  1. If installed, first uninstall the StormRunner Load Generator Upgrade Patch.
  2. Uninstall the StormRunner Load Generator.

Note: If both the StormRunner Load Generator and the StormRunner Load Generator Upgrade Patch are installed and you uninstall only one of them, the load generator will not be usable.

Back to top