Install an OPLG - Windows

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

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.

If your Web Services scripts depend on the obsolete Axis toolkit, you must manually copy the Axis files to %LG_PATH%bin\java\Axis. You can download the Axis files from the OpenText Support Portal.

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

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

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

If there is no connection between OpenText Core Performance Engineering 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 allowed lists, submit a service request to request the IP addresses. For details, see Dedicated IP addresses.

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 in your on-premises load test cannot exceed the maximum number of Vusers in your license.

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

If you have requested multiple IP addresses for a load test, ensure you have assigned all the valid IP addresses to the load generator machine so that OpenText Core Performance Engineering can use them during the test.

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

1. On the Navigation menu , select Assets > Load Generators.

2. Select the load generator from the list, or click the Create button to add a new one.

3. In the New load generator dialog box, configure the following and click Save.

   1. Give the load generator a meaningful name and description.

   2. Select Windows as the operating system.

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

4. A key is generated for the load generator and is displayed in the details. Copy the Key value for later use.

On each machine that you want to install a load generator, download the installation .zip file from the banner menu, Tools and integrations > Agents > OPLG, and extract the contents.

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

If the machine on which you want to install the load generator already contains an on-premises load generator, refer to Update an OPLG.

To install the load generator components manually:

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 accept or select the installation location.

   4. In the OneLG Configuration step, select OpenText Core Performance Engineering 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 Configure Load Generator and 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 OpenText Core Performance Engineering server can 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.

• To run JMeter or Gatling scripts on on-premises load generators, make sure to select the Install JMeter/Gatling after installation option during setup.

1. Open the load generator configuration tool.

2. On the General tab, enter:

   • The load generator key that you noted earlier

   • Your credentials: the OpenText Core Performance Engineering username/password or client ID/secret key. Tenants created before version 24.3 can authenticate using the username/password or OAuth authentication methods. However, tenants created for version 24.3 and higher can only authenticate with the OAuth method with a client ID and secret key. The preferred and more secure method is to always authenticate with a client ID and secret key, even for earlier versions. For details, see API access keys.

   • Your Tenant ID

3. 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.

4. Click Save & Test to save your settings and test your connection to the OpenText Core Performance Engineering 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 OPLG configuration tool.

Go to Start > ...> Start Load Generator.

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

Contact your account manager or sales representative.

In Load tests > Test settings, select the Enable multiple IP addresses checkbox.

Make sure that the required number of valid IP addresses have been allocated on the relevant on-premises load generator.

If the machine on which you want to install the latest load generator already contains version 2020.07 or later of the on-premises load generator, perform the following actions:

1. In the banner, go to Tools and integrations > Agents > OPLG. Download the installation package zip file and extract its contents.

2. Make sure the existing load generator agent on the machine has been closed, and that all load generator agent processes have been terminated.

3. Install the new version. No backup, uninstall, or restart is required. For details, see Set up an on-premises load generator.

4. If a patch for the current version is available, it also appears in the OPLG section of the Agents tab. For example, if you have OPLG for version 2023.07, click the button Patch for 2023.07. You must have the full installation of the OPLG before installing its patch.

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

1. (Optional) Back up the sample_conf.json file, located in the <installation_folder>\testexec.server\stormagent\ folder.

2. In the banner, go to Tools and integrations > Agents > OPLG. Download the installation package zip file and extract its contents.

3. Uninstall the old version. For details, see Uninstall an OPLG.

4. Reboot the machine.

5. Make sure the existing load generator agent on the machine has been closed, and that all load generator agent processes have been terminated.

6. Install the new version. For details, see Set up an on-premises load generator.

7. (Optional) If you backed up the old load generator's sample_conf.json configuration file, copy it to the new installation, overwriting the newer, empty configuration file. The new, empty configuration file’s path is: C:\Program Files\<installation_folder>\testexec.server\stormagent\.

option1: true

option2: true