Create and manage tests

This section describes how to create and manage LoadRunner Enterprise tests in the test management page. You can also upload test scripts, and view and edit scripts details and parameters from this page.

In this topic:

Create a test folder

Test folders are used for storing your LoadRunner Enterprise tests and scripts.

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. In the test management tree, select any folder node (other than the "Unattached" folder), and click New Folder.

3. Enter a name for the test folder.

   Note: A folder name cannot include the following characters: \ ^ *

Back to top

Manage test folder assets

You can view and manage all tests and scripts in a test folder, and get run details for all tests in the selected test folder.

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. In the test management tree, select a test folder.

   All the scripts and tests in the folder are displayed in the Tests and Scripts pane.

3. Click the Tests and Scripts tab to get details on a test or script.

   Action	How to
   Preview a script or test	Select a script or test in the Subject area. Details of the selected test or script are displayed in the preview pane on the right. For details, see Preview a script or View test details.
   Add test assets	Click New Test, and add a new test. For details, see Create a test.
   Copy or move test assets	Right-click the asset you want to copy or move, and select Copy/Paste or Cut/Paste.
   Delete test assets	Select the assets you want to delete, and click Delete. For details, see Delete a test or test folder.
   Upload script	Click Upload Scripts, and then continue from step 2 of Upload scripts.
   Open test Designer window	Select a test in the Tests area. Click the ID link. The test opens in the Performance Test Designer window. For details, see Groups and Workload tab (Performance Test Designer).
   Sort or filter test assets	For details, see Personalize your display.

4. Click the Runs tab to display run details for all tests in the selected test folder. For details, see Manage test runs and results.

Back to top

Upload scripts

Upload the scripts you want to use in your tests to LoadRunner Enterprise.

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. In the test management tree, select a destination folder for the scripts, or create a new folder.

   Note: The folder name must not contain a forward slash (/). Either rename the folder so that it does not contain a forward slash (/) or upload scripts directly from VuGen.

3. Click Upload Scripts, and configure the following settings.

   Action	How to
   Select scripts	Click the Select button, and navigate to the directory where the scripts you want to upload are stored. Select the scripts to upload and click Open. Note: The scripts must be saved locally, must be in ZIP format, and must include all the files in the test scripts folder. The file path inside a script folder must not exceed 260 characters.
   Configure upload settings	Configure the following upload settings: Select the action to take if the script already exists in the destination folder: Auto Rename Script. Automatically gives the script a different name. Overwrite Existing Script. Overwrites the existing script. Select the method to use for uploading the script: Upload All Files. Uploads all the files contained in the .zip file. With this option the upload takes a long time. Upload run time files only. Only the run time files—that is the scripts, runtime settings, parameters, and so on—are uploaded. For version enabled projects, select Keep checked out to keep the uploaded scripts checked out. Note: When you upload a script, it is available only for your own use until you check it in. After you check the script in, other users can access the script as well.
   Upload the scripts	Click Upload to upload the selected scripts to the specified destination folder.

Back to top

View or edit scripts

You can view details of scripts uploaded to LoadRunner Enterprise, and edit script parameters from the script preview page.

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. Click a script in the test management tree to display the script preview in the right pane. You can also search or filter the tree for scripts:

   Action	How to
   Search for scripts	Click to search for scripts by name. Type the name (or part of the name) in the search box. LoadRunner Enterprise displays all scripts that contain the search string.
   Filter the tree for scripts	Click the Filter dropdown and select Script to display scripts only. Select All to display all LoadRunner Enterprise tests and scripts.

3. View or edit a script from the Testing page.

   Action	How to
   Preview a script	View the following script details in the preview pane. Script Name. The name of the script. Type. The script type selected. Last Update. The date and time that the script was last updated. Actions. Each Vuser script contains at least three sections: vuser_init, one or more Action sections, and vuser_end. For details of script sections, see Vuser Script Sections in the Virtual User Generator Help Center. Click the link to display details of the selected section in the right pane. Included Files. A list of other files include with the script. Click the Description tab to view a description of the script.
   Add script description	Click the Description tab to view or add a script description.
   View related tests	Click the Related Tests tab to view details of all tests in which the currently selected script is used. Click the ID link to open the related test in the Performance Test Designer window. For details, see Groups and Workload tab (Performance Test Designer).
   View script attachments	Click the Attachments tab to view or add attachments that provide additional information about the currently selected test. For details, see Attachments tab.
   Edit script parameters	Click Edit Parameters to open the Parameters dialog box, enabling you to modify any parameters that are in the script. For details, see Edit script parameters. Note: If you edit a parameter, the change will affect every performance test in the current project that uses the script.
   Download the script	Click Download to download the script.

Back to top

Create a test

You can create a new test from the Test Management tree or from the Create New Performance Test dialog box.

Create a test from the Test Management tree

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. In the test management tree, select a folder in which you want to create a test or create a new folder, and click New Test.

3. In the Create New Performance Test dialog box, define the test:

   Test Name	Enter a name for the performance test.
   Assign Test Set	Select an existing test set to which to assign the test, or click Edit Test Sets, and create a new test set in the Manage Test Set dialog box. For details, see Create, edit, or assign a test set.
   Workload/Schedule types	Select a type of workload for the performance test. For details of workload types, see Vuser distribution methods.

4. Click OK. The test opens the Performance Test Designer window. For details, see Groups and Workload tab (Performance Test Designer).

   Continue from step 3 of Define test workloads.

Create a test from the Create New Performance Test dialog box

1. From the LoadRunner Enterprise navigation toolbar, click and select Create New Test.

2. In the Create New Performance Test dialog box, define the test:

   Test Name	Enter a name for the performance test.
   Test Folder	Select a folder in which to create the test. For details on creating a folder, see create a new folder.
   Assign Test Set	Select an existing test set to which to assign the test, or click Edit Test Sets, and create a new test set in the Manage Test Set dialog box. For details, see Create, edit, or assign a test set.
   Workload/Schedule types	Select a type of workload for the performance test. For details of workload types, see Vuser distribution methods.

3. Click OK. The test opens the Performance Test Designer window. For details, see Groups and Workload tab (Performance Test Designer).

   Continue from step 3 of Define test workloads.

Back to top

Create, edit, or assign a test set

You must assign a test to a test set before you can run the test. A test can be assigned to more than one test set.

Create a test set

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. Select an existing test, or create a new test.

3. Define a test set.

   1. In the Create New Performance Test dialog box, click the Assign Test Set drop-down arrow, and select Edit Test Sets.

   2. In the Manage Test Sets dialog box, click , and specify a name for the Test Set folder.

   3. Select the test set folder you created, and click New Test Set.

   4. Enter the test set name, and then click Close.

4. Select a type of workload for the performance test. For details of workload types, see Vuser distribution methods.

Edit a test set

You can edit a test set.

1. Select the test to which the test set is assigned (LoadRunner Enterprise > Test Management). Select the Test Details tab, and click the Assigned Test Set drop-down arrow.

2. Click Edit to open the Assign and Select Test Set dialog box from where you can perform the following actions:

   Action	How to
   Add a test set	Click Assign Test Set to create a new test set in the Manage Test Set dialog box, and then assign it to the test.
   Delete a test set	Click Remove from Test Set to remove the attached test set from the test.

Assign or change an assigned test set

You can assign a test set as follows:

• For a new test: In the Create new performance test dialog box, select the test set you want to assign to the test and click OK.

• For an existing test: Select a test from the test management tree (LoadRunner Enterprise > Test Management), and in the Test Details tab, click the Assigned Test Set drop-down arrow. Select the test set you want to assign to the test and click OK.

Back to top

View or edit tests and test runs

To view or edit LoadRunner Enterprise tests:

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. Click a performance test in the test management tree. You can search or filter the tree for specific tests or test folders:

   Action	How to
   Search for tests or test folders	Click to search for tests or test folders by name. Type the name (or part of the name) in the search box. LoadRunner Enterprise displays all tests and/or folders that contain the search string.
   Filter the tree for tests	Click Test to display LoadRunner Enterprise tests only. For test details, see Edit or run a test from the Testing page. Click All to display LoadRunner Enterprise tests and scripts.

3. Edit or run a test from the Testing page.

   Action	How to
   View test details	Click the Test Details tab to display details about the test. This includes: Test Summary area. Provides an overview of the test, including test status, workload type, and resources required for the test. Last Run. Details from the last time the test was run. Test Runs Trend. Displays a trend graph which monitors the test runs of the selected test over time. For details, see Test Runs Trend view and tab (Performance Test Designer) Description. A description of the test. Click to add or modify the test description, and then click . For details, see General Details Pane.
   Add the test to a test set	In the Test Summary area, click the Assigned Test Set drop-down arrow to assign a test set to the test, or to edit an existing test set. For details, see Assign or change an assigned test set.
   View or edit the test in XML mode	Click the Coded Test tab to view the test data in XML format. For details, see View or edit a test in XML mode (Coded test).
   View test run details	Click the Runs tab to manage results and related actions for test runs. For details, see View test run details.
   View test assets	Click the Relations tab to display all assets (monitors and scripts) associated with the currently selected test. For details, see Related Monitors Pane (Summary view only).
   Manage test attachments	Click the Attachments tab to view or add attachments that provide additional information about the test. You can attach a file or URL. For details, see Attachments tab.
   View test changes	Available in version: LoadRunner Enterprise 2020 SP1 and later. Click the Audit tab to display a list of changes made to the currently selected test. For details, see View changes made to a test run. Note: Administrators can display a list of changes made to other entity types, such as projects, users, hosts, and roles from LoadRunner Enterprise Administration. For details, see View log files.
   Edit test	Click Edit Test to open the Performance Test Designer window where you design performance tests. For details, see Performance Test Designer window.

Back to top

View or edit a test in XML mode (Coded test)

The Coded Test feature enables you to view and modify tests in XML format, making it easier to make changes directly to your tests.

To open a test in XML format:

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. Select a test in the test management tree. The Test Details pane is displayed for the selected test.

3. Click the Coded Test tab. The selected test is displayed in XML format.

To edit a test:

1. Make changes directly in the XML file as required.

   • You can use the auto-complete feature to select parameters.

   • Use the context menu to cut, copy, or change all occurrences functionality. You can also open the Command Palette which holds frequently used functionality, such as sorting, changing the syntax and changing the indentation settings.

2. To view your changes, click Compare to Original. The XML comparison tool compares the two XML files side-by-side, and highlights the differences between them.

3. After making changes, click Save Test. A panel opens in the lower part of the screen displaying the validation XML.

Back to top

Run a test

To run a LoadRunner Enterprise test:

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. Select a test in the test management tree. The Test Details pane is displayed for the selected test.

3. Click Run Test in the upper-right side of the pane.

   • If the selected test is assigned to a single test set, the Run Test dialog box opens.

   • If the selected test is assigned to more than one test set, or if the selected test is not assigned to a test set, the Assign and Select Test Set dialog box opens. Select a test set and click Run. The Run Test dialog box opens.

4. In the Run Test dialog box, create a timeslot reservation, or run the test in a reserved timeslot.

   Create a timeslot reservation:

   1. Open the New Timeslot tab to create a new timeslot. If the current resources are insufficient for the selected test, you will be unable to reserve a timeslot to run the test.

   2. Configure the following timeslot settings:

      UI Element	Description
      Duration	The amount of time, in hours and minutes, that you need the resources reserved.
      Requested Resources	The resources being requested for this test.
      VUDs	Requests VUDs Vusers for the test rather than regular Vusers. For details about VUDs, see Manage licenses.
      Post-Run Action	The action to be taken when the test run is complete. If the system administrator has set the post-run action, the selected action will be set as the only option for all tests across the project, and you will not be able to change the setting. If the system administrator has not set the post-run action, select one of the following the actions: Do not collate results. Frees the machines immediately after the performance test ends. When the run has finished, the run results are left on the load generators. You can analyze the results at a later stage from the Results. Collate results. When the run has finished, the run results are collected from all the load generators. This is recommended because collation of results takes only a few minutes, and can prevent loss of or inaccessibility to results in case any of your load generators becomes unavailable. Collate and analyze results. When the run has finished, the run results are collected and analyzed. Data analysis requires some time, depending on the size of the results file. If there is no timeslot available to include the data analysis, select the Collate results option instead, and run late Analysis when a data processor becomes available. You run late Analysis from the Results tab. For user interface details, see Manage test results. Note: This feature controls the action performed immediately after the run ends. It does not prevent collating or analyzing results from the Test Runs page at a later time.
      Calculate Availability	Calculates the availability of the resources required for running the test and checks whether a new timeslot can be created.
      Availability results	Displays the results of the availability verification. If your timeslot cannot be reserved, the reason will be displayed.
      Run	Uses the hosts reserved by the selected timeslot and runs the test. The Performance Test Run page opens. For details, see View the Performance Test Run page (online screen).

   Run a test in a reserved timeslot:

   Select the Reserved tab to run a test in a reserved manual timeslot that has been assigned to your test, or in a timeslot that has not been assigned to any test. If there are no timeslots available, you will be unable to schedule your test.

   The Reserved tab displays the following:

   UI Element	Description
   Duration	The duration of the timeslot.
   Requested Resources	The resources being requested for this test.
   VUDs	Requests VUDs Vusers for the test rather than regular Vusers. For details about VUDs, see Manage licenses.
   Post-Run Action	See Post-Run Action above.

Back to top

Delete a test or test folder

To delete a LoadRunner Enterprise test pr test folder:

1. From the LoadRunner Enterprise navigation toolbar, click and select Test Management (under Testing).

2. Select a test or folder from the test management tree, and click Delete.

   • When deleting a folder, the selected folder is deleted and all related tests are moved to the Unattached folder. You cannot delete the root Subject folder.

   • When deleting a test, the selected test is deleted permanently. In addition, all test runs associated with the deleted test are deleted from the project and removed from any associated test sets.

   Note: Deleting a performance test that is linked to a timeslot will affect the timeslot.

Back to top

See also:

• Design performance tests
• Manage scripts