Distribute load generators

This topic describes the different types of load generators, and how to distribute them to groups in a performance test. It also describes how to assign elastic load generators to a test.

Load generator types

A load generator is a host machine on which Vusers run during a test. There can be many load generators for a given test.

There are four types of load generators:

Type

Description

Specific An actual load generator. For example, machine host1, located in London.
Automatch A load generator placeholder, for example LG1. When you assign an automatch load generator to a Vuser group, you are not assigning a specific load generator to the group, but rather a placeholder for a load generator with specific properties. At runtime, specific load generators in the host pool of the project that have the same properties as the automatch load generators, are allocated in place of the automatch load generators.
Elastic Cloud

(Available only if a cloud account has been set up for provisioning load generators and cloud hosts have been provisioned.)

A load generator placeholder, for example CLOUD1, that is provisioned on the cloud. When you assign an elastic cloud load generator to a Vuser group, you are assigning a placeholder for a load generator with specific properties according to the load generator image. At runtime, the required number of cloud load generators are provisioned and allocated in place of the elastic load generators. When the run finishes, the cloud load generators are de-provisioned.

Note: Each cloud load generator you assign is considered as a group. Therefore, if you define a test with three cloud load generators under one Vuser group (script), you will see three groups for each load generator when the test runs.

Elastic Docker

(Available only if the project is linked to an orchestrator in LoadRunner Enterprise Administration.)

A load generator placeholder, for example DOCKER1, that is installed and run on a Docker distribution. When you assign an elastic dockerized load generator to a Vuser group, you are assigning a placeholder for a load generator with specific properties according to the load generator image. At runtime, the required number of dockerized load generators are provisioned and allocated in place of the elastic load generators. When the run finishes, the Docker containers and load generators are de-provisioned.

Note: Each dockerized load generator you assign is considered as a group. Therefore, if you define a test with three dockerized load generators under one Vuser group (script), you will see three groups for each Docker container when the test runs.

Back to top

Estimate how many load generators you need

To estimate the number of load generators that are needed to run a Vuser script, you can use the Load Generator Calculator tool (Technical Preview). On the host machine, select Start > Programs > Micro Focus Software > LoadRunner Enterprise Host > Tools > Load Generator Calculator.

Back to top

Customize load generator attributes

You can customize load generator attributes.

When customizing load generator attributes, consider the following:

  • Create attributes that represent properties about your hosts that will help tell one host apart from another host when using them for performance testing.

  • Because you can select multiple attributes for your host, you can define an unlimited number of host attributes. They do not need to be related.

  • Host attributes can refer to anything. For example, Host Memory - High, Spanish environment, Very slow machine.

To customize host attributes:

  1. In LoadRunner Enterprise Administration, select Maintenance > Hosts, and click Edit Host Attributes.

  2. To add an attribute, click Add Host Attribute. Enter a name for the attribute in the Add New Host Attribute box, and click Add. The host attribute is added to the host attributes list.

  3. To delete attributes, select the attributes you want to delete and click Remove Host Attribute. The selected host attributes are removed from the host attributes list.

  4. To edit an attribute, select the attribute you want to change and click Edit Attribute. Modify the attribute as required, and click Save.

Back to top

Distribute load generators among Vuser groups in a test

This task describes how to distribute load generators among Vuser groups participating in the performance test.

  1. Prerequisites

    Add Vuser groups to participate in the test. For details, see Define test workloads.

  2. In the Performance Test Designer window, click Groups & Workload. On the Groups pane toolbar, click Assign LG. The Assign Load Generators dialog box opens. For user interface details, see Assign Load Generators to Groups dialog box.

  3. Select the groups to use in the test

    In the Groups column, select the groups to which you want to assign load generators. You can use to search the list of groups by name.

    If load generators have already been assigned to a group, you can see the list by clicking the button. You can unassign load generators using the x or Unassign All button.

  4. Specify the load generators to assign to the groups

    1. In the Load Generators column, select the load generators you want to assign to the selected groups from the following load generator types: Specific, Automatch, Elastic Cloud and/or Elastic Docker. For an explanation about the different load generator types, see Load generator types.

      You can use to search the list of load generators by name or attributes.

      Note:  

      • The Elastic Cloud tab is displayed only if the project has been linked to a cloud account. For details, see Cloud accounts.

      • The Elastic Docker tab is displayed only if the project has been linked to an orchestrator. For details, see Configure elastic dockerized hosts.

      • For automatch or elastic load generators: You can add additional load generators to the list by clicking , and entering the number of additional load generators required for the test. You can also, update load generator properties by clicking the Properties link. For details, see Load Generator Management dialog box.

    2. Select the check box for each load generator you want to assign to the selected groups.

      To select multiple load generators, click and drag a box around the load generators you want to select. To select all load generators in the column, select the check box next to the Name column heading, or press CTRL + A.

    3. Click to open the Preview window, where you can review all the load generator assignments.

    4. Click Assign to assign the selected load generators to the selected groups in the test, and then click OK to save your changes.

      Conversely, if you unassigned load generators from groups, click Unassign, and then click OK to save your changes.

  5. Select properties for the automatch load generators - optional

    You can select properties for the automatch load generators that are assigned to Vuser groups in your test. Properties include a location and other attributes. At runtime, each automatch load generator is matched up with an available specific load generator (in the host pool of the project) with the same properties.

    1. To select properties for automatch load generators, expand the Automatch tab, and click the LG<#> link to open the Load Generator Management dialog box.

    2. Select one or more automatch load generators for which you want to define the same settings, and enter a location and/or host attributes.

      You can also use to copy properties from one automatch load generator, and to paste them to multiple automatch load generators.

      To see the updated properties for an automatch load generator, you need to clear the check box, and then select it again.

    For user interface details, see Load Generator Management dialog box.

    Note: If no properties are specified, the automatch load generator is matched up with any load generator in the project's host pool.

Back to top

Assign elastic hosts to a test

Using Elastic Cloud and Elastic Docker hosts automates the testing process by provisioning and de-provisioning hosts on demand, and seamlessly adding them to tests on the fly without having to reserve resources in advance.

  1. Prerequisites

  2. Select a test

    From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing). Select a performance test in the test management tree, and click Edit Test.

  3. Assign elastic cloud-based or dockerized load generators to Vuser groups

    Follow the steps in Distribute load generators among Vuser groups in a test, and assign elastic load generators to the groups for the test.

  4. Set Post-Run Action to collate results (if your LoadRunner Enterprise administrator did not set a post-run action)

    To ensure that run results are not lost after a performance test ends (since elastic hosts are freed immediately after the run finishes), we recommend you select Collate results. For details, see Post-Run Action.

  5. Run the performance test

    Save and then run the test to check its performance. For details on running a test, see Run performance tests.

    When the test has finished, the elastic hosts are automatically removed from the test.

Back to top