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.

Below are the different 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.

For more details, see Manage elastic cloud hosts.

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.

For more details, see Configure elastic dockerized hosts.

LRE CloudBurst

(Available only if a LoadRunner Enterprise CloudBurst account has been set up and the project has been linked to the account)

A LoadRunner Enterprise CloudBurst load generator is provisioned and de-provision on the cloud without having to maintain subscriptions with cloud providers.

At runtime, the required number of cloud load generators are provisioned and allocated. When the run finishes, the cloud load generators are de-provisioned.

For more details, see Assign groups to run on LoadRunner Enterprise CloudBurst load generators.

Note: Each Elastic or CloudBurst load generator you assign is considered as a group. Therefore, if you define a test with three Elastic or CloudBurst load generators under one Vuser group (script), you will see three groups for each load generator or 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. Distribute load generators

    1. In the Performance Test Designer window, select the Groups and Workload tab.

      If load generators have already been assigned to a group, the script name and type, and the number of assigned Vusers and load generators are displayed. Click Show LG names to display the names of the load generators. You can also view details of assigned load generators in the Load Generators tab.

      Click Filter to filter the list of groups displayed in the grid. For details, see Filter.

      If you want to replace the script assigned to the group with a different script, select the script and click Replace script for existing group. Select a script to replace the existing one assigned to the group, and click Replace & Close.

    2. From the Groups pane toolbar, click the Assign LGs/ Assign CloudBurst dropdown and select the type of load generators you want to assign to each group:

  3. Select the groups to use in the test

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

  4. Specify the load generators to assign to the groups

    1. In the Load Generators pane, select the load generators you want to assign to the selected groups from the load generator types (see Load generator types).

      You can use to search the list of load generators by name or attributes. The number of each load generator type already assigned to the Vuser group are displayed adjacent to the load generator type tab.

      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.

      • You can add additional automatch or elastic load generators to the list by clicking Add LGs, 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 all load generators in the column, select the check box next to the Name column heading

    3. Click Apply Assignment to assign the selected load generators to the selected groups in the test.

      Conversely, if you want to unassign load generators from a group, clear the check box for each load generator you want to unassign, and click Apply Assignment.

    4. Click Save Test to save your settings.

    5. To view all load generators assigned to a group, select the group in the Groups pane, and in the group details pane on the right, select the Load Generators tab. The grid displays the name and load generator type, and the number of groups to which the load generator is assigned.

    6. If you want to unassign load generators from groups or replace them with other load generators, select the groups and load generators that you want to change, and select Unassign or Replace with another LG.

    7. If you want to unassign load generators from groups, select the groups and load generators that you want to unassign, and select Unassign.

    8. If you want to replace load generators with other load generators, select the groups and load generators that you want to change, and select Replace with another LG. In the Replace Load Generators dialog box, select the load generators you want to assign to the selected groups.

  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, select More > LG Management 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, Elastic Docker, and CloudBurst hosts automates the testing process by provisioning and de-provisioning hosts on demand, and seamlessly adds 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