Create a scenario Add Load Generator machines Schedule replay runs Monitor the performance Analyze the results

How to Run a Scenario

This task describes how to run a scenario.

  1. Prerequisite

    Open an existing scenario, or design a new one.

  2. Prepare to run the scenario

    Before you run the scenario, specify a location for the scenario results and other runtime related settings. For details, see How to Prepare a Scenario to Run.

  3. Set the ramp up method to round-robin - optional

    To enable the round-robin ramp up, search for the wlrun7.ini file, located in the %windir%. In the [ScenarioDesign] section, set the DitributionByHostsInPrecentageMode flag to 1. For details, see Running Scenarios Overview.

  4. Run the scenario

    In the Run tab, click the Start Scenario button to begin running the scenario. The scenario runs according to its defined schedule.

    Note: When the Controller starts the scenario, it checks the versions of each VuGen script and its designated load generator machine. The Controller detects a mismatch if the version of the script is later than that of the load generator, or if either the script or load generator version is undefined (for example in earlier load generator versions).

    If there is a mismatch, the Controller log shows a message that the versions do not match and the script may not run properly. You can stop the scenario and try to resolve the mismatch by upgrading your load generator, for example. Alternatively, you can let the scenario continue running and determine whether there were any other errors.

  5. Manually control the behavior, addition, and stopping of Vusers during the scenario run - optional

    You can do the following during the scenario run:

    • Control the behavior of Vuser groups. You can initialize, run, and stop Vuser groups during the scenario run.

    • To initialize, run, or stop an entire Vuser group, select the group in the Scenario Groups pane, and click the desired button on the main Controller toolbar:

      • Initialize Vusers.

      • Run Vusers.

      • Stop Vusers immediately.

      • Stop Vusers gradually.

    • Run or stop individual Vusers. You can run or stop specific Vusers within a Vuser group. For user interface details, see Vusers Dialog Box.

    • Initialize/Run additional Vusers, or stop currently running Vusers. You can manually control the addition of new Vusers to a running scenario, as well as stop running Vusers. For user interface details, see Run/Stop Vusers Dialog Box.

  6. View a log containing runtime information about each running Vuser - Optional

    For user interface details, see Vuser Script Log.

  7. Release Vusers from a rendezvous before the Controller releases them - Optional

    For more information, see Rendezvous Points.

  8. Log execution notes during the scenario run - Optional

    The Controller provides you with a dialog box in which you can log comments while a scenario is running. To open the dialog box select Scenario > Execution Notes. The notes are automatically saved by clicking OK to close the dialog box.

  9. Monitor the scenario - optional

    During the scenario run, you can view data collected by the online monitors using the online monitor graphs. If you did not set up the monitors before you started the run, you can do so during the run. The data collected by the monitors can be viewed using the LoadRunner online graphs.

  10. Collate run results

    If you are using the default file storage setting—local machine, when the scenario run is complete, the run results must be collated or consolidated in preparation for result analysis. If LoadRunner is not set up to collate the results automatically upon completion of the run, you need to collate the results manually after the run.

    Select Results > Collate Results > Collate Results. For details, see How to Collate Scenario Run Results.

    For details about result collation, see Collating Run Data.

Back to top