Install an on-premises load generator on Windows

Use LoadRunner Cloud (LRC) 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

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.

We recommend that you always use the most current version of the on-premises load generator.

The recommended system requirements for supported on-premises load generator versions are:

On-premises load generator version On-premises load generator 2020.10

Using LoadRunner load generator 2020 SP3

On-premises load generator 2020.07

Using LoadRunner load generator 2020 SP2

On-premises load generator 2020.05

Using LoadRunner load generator 2020 SP1

Operating system

 

  • Microsoft Windows 8.1 64-bit*
  • Microsoft Windows 10 64-bit versions 1607, 1803, 1809, 1903, 1909, 2004 - Recommended)
  • Microsoft Windows Server 2012 R2 64-bit*
  • Microsoft Windows Server 2016 64-bit** (Recommended)
  • Microsoft Windows Server 2019 64-bit

* Can only be used with Microsoft Internet Explorer 11.

** We recommend enabling Desktop Experience when using this operating system.

  • Microsoft Windows 8.1 64-bit*
  • Microsoft Windows 10 64-bit versions 1607, 1709, 1803, 1809, 1903, 1909 - Recommended)
  • Microsoft Windows Server 2012 R2 64-bit*
  • Microsoft Windows Server 2016 64-bit** (Recommended)
  • Microsoft Windows Server 2019 64-bit

* Can only be used with Microsoft Internet Explorer 11.

** We recommend enabling Desktop Experience when using this operating system.

  • Microsoft Windows 8.1 64-bit*
  • Microsoft Windows 10 64-bit versions 1507, 1607, 1709, 1803, 1809, 1903, 1909 - Recommended)
  • Microsoft Windows Server 2012 R2 64-bit*
  • Microsoft Windows Server 2016 64-bit** (Recommended)
  • Microsoft Windows Server 2019 64-bit

* Can only be used with Microsoft Internet Explorer 11.

** We recommend enabling Desktop Experience when using this operating system.

Processor 8 core CPU 8 core CPU 8 core CPU
Memory 16 GB 16 GB 16 GB
Free disk space

100 GB; SSD drive

Note: During installation, the installer checks for space on the drive on which the temp directory is located (as configured in the user’s local environment variables).

100 GB; SSD drive

Note: During installation, the installer checks for space on the drive on which the temp directory is located (as configured in the user’s local environment variables).

100 GB; SSD drive

Note: During installation, the installer checks for space on the drive on which the temp directory is located (as configured in the user’s local environment variables).

Bandwidth A bandwidth of at least 1Gbs is recommended for communicating with the LoadRunner Cloud servers. A bandwidth of at least 1Gbs is recommended for communicating with the LoadRunner Cloud servers. A bandwidth of at least 1Gbs is recommended for communicating with the LoadRunner Cloud servers.

Note: The LoadRunner components used in the LoadRunner Cloud on-premises load generator may require certain Windows updates. Install the updates as needed. For more information about system requirements, refer to the LoadRunner and LoadRunner Enterprise Host System Requirements (Windows) section in the LoadRunner Professional Help Center (make sure to select the correct version).

Back to top

Notes and limitations

Limitation/Note Solution
.NET 3.5 If your scripts require .NET 3.5, you must manually install or activate them on the on-premises load generator machine.
WSE

If your scripts depend on Web Services Enhancements (WSE), you must manually install WSE 2.0 SP3 and WSE 3.0 for Microsoft .NET.

Note: Both WSE installations require .NET 3.5.

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 LoadRunner Cloud

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

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

If you receive a system error -1030, check the network connectivity between your on-premises load generator and the cloud (AWS). Also ensure that outbound communication over port 443 is enabled.

If your company's security or firewall requires static IP addresses for white listing, Open a support ticket to request them.

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 LoadRunner Cloud can use them during the test.

For details on working with multiple IP addresses, see Enable multiple IPs from cloud and on-premises load generators.

Back to top

Set up an on-premises load generator

This section describes how to set up and install an on-premises load generator.

The installer package, OneLG, is a combined load generator installer for all of the LoadRunner family products: LoadRunner Professional, LoadRunner Enterprise, and LoadRunner Cloud. During the installation, you select the relevant product to allow the installation to make the appropriate configurations. After the load generator installation is complete, you can reconfigure the load generator to work with a different tool from the LoadRunner family.

Action How to
Define your load generator in LoadRunner Cloud and note the key:
  1. In LoadRunner Cloud, 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. Copy the Key value 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 LoadRunner Cloud Home page > Get tools > Agents > Get Load Generator, and extract the contents.

Note: 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

Note: If the machine on which you want to install the load generator already contains an on-premises load generator (version 2020.05 or earlier), perform the following actions:

Manual installation

  1. Unzip the downloaded load generator installation package, SetupOneLG.zip.
  2. Run the extracted file SetupOneLG.exe as an administrator.

    1. Extract the installation packages into a temporary folder.
    2. Install the required prerequisite programs when you are prompted to do so.
    3. Accept the license agreement and select the installation location. By default, the location is C:\Program Files (x86)\Micro Focus\LoadRunner OneLG. We recommend that you use the location: C:\LoadRunnerCloudLG.
    4. In the Micro Focus LoadRunner OneLG Configuration step, select LoadRunner Cloud and click Install to start the installation of the load generator and the other required applications.
  3. When the installation is complete, the setup program creates the LoadRunner Cloud - Configure Load Generator and LoadRunner Cloud – Start Load Generator shortcuts on the Desktop, and opens the load generator configuration tool.

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

Note:

  • The load generator and the LoadRunner Cloud server will be able to communicate only after the load generator is configured properly.

  • If you receive an error during the installation indicating that there is not enough disk space, refer to Troubleshooting for possible solutions.

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

    • The load generator key that your noted earlier
    • Your LoadRunner Cloud 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 LoadRunner Cloud 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 > Micro Focus > LoadRunner Cloud - Start Load Generator.

Tip: For best results, run the load generator as an administrator.

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 > Micro Focus > LoadRunner Cloud - Configure Load Generator.

Back to top

Run the load generator as a service

To run an on-premises load generator as a service:

  1. Open the built-in Windows Task Scheduler (Control Panel > Administrative Tools > Schedule tasks).
  2. Schedule a task which automatically starts the LoadRunner Cloud - Load Generator Agent at system startup.

    • The executable file of the agent is
      %LG_PATH%LRC\testexec.server\stormagent\bin\start_stormagent.cmd.
    • You can also find the file location through the Desktop shortcut.

Back to top

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 LoadRunner Cloud Contact your account manager or sales representative.
Enable multiple IP addresses for a load test From LoadRunner Cloud > 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 IPs from cloud and on-premises load generators.

Back to top

Run a test using an on-premises load generator

Action How to
Create a test

From LoadRunner Cloud > 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 LoadRunner Cloud Load Generators to use for your test.

For more information, see Manage load tests.

Back to top

Update an on-premises load generator

This section describes how to update an on-premises load generator to the latest version.

Back to top

Perform a silent OPLG installation

A silent installation, also known as unattended install, has multiple benefits. If you installed the OPLG (on-premises load generator) with the latest OneLG installation, you can imbed a silent installation into the software installation process.

This capability allows you to automate installation and updates on multiple remote machines, instead of having to log in to each machine separately and manually installing the OPLG.

To perform a silent installation, run a Windows command line as an administrator and enter the command: SetupOneLG.exe /s /a /s IS_RUNAS_SERVICE=2 START_LGA=0 INSTALLDIR="C:\LoadRunnerCloudLG"

Back to top

Uninstall an on-premises load generator

To uninstall the on-premises load generator (version 2020.05 or earlier):

  1. Open the Control Panel. Go to Programs and Features.
  2. In the list of programs, locate LoadRunner Cloud - Load Generator. Select it and click Uninstall.

To uninstall the on-premises load generator (version 2020.07 or later):

  1. Open the Control Panel. Go to Programs and Features.
  2. In the list of programs, locate Micro Focus LoadRunner OneLG. Select it and click Uninstall.

Back to top

See also: