Manage performance tests

This section describes how to create and manage Performance Center 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 Performance Center tests and scripts.

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

2. In the test management tree, select the Subject root folder or 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 Performance Center 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.
   Use version control to make changes to test assets	You can check out one or more test assets (scripts and/or tests) in a version control enabled project and make changes to them. For details on enabling version control, refer to the ALM Administrator Guide: Enabling and Disabling Version Control for a Project. Select the assets you want to check out, and click Check out. An entity checked out by the current user is displayed with an open green lock icon . An entity checked out by another user is displayed with a red lock icon. After you have finished making changes, select the assets you want to check in, and click Check in. The new versions are then available to other users. The version number assigned to a new entity is 1. When an entity is checked in, the version number is increased by one. To cancel the check out of selected entities and discard changes, click Undo Check out. When you undo a checkout, any changes you made to non-versioned fields while the entity was checked out are not cancelled and the new values remain. Note: You can also perform these actions from the tests tree using the context menu
   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 Performance Test Designer > Groups and Workload.
   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 View and manage test run results.

Back to top

Upload scripts

Upload the scripts you want to use in your tests to Performance Center.

1. From the Performance Center 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 Scripts 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.
   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 Performance Center, and edit script parameters from the script preview page.

1. From the Performance Center 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. Performance Center displays all scripts that contain the search string.
   Filter the tree for scripts	Click Script to display VuGen or JMeter scripts only. Click to display all Performance Center 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 sectsnippetions, 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.
   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 Performance Test Designer > Groups and Workload.
   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. Note: Attachments should be limited to no more than 10 MB in size (per file).
   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 Performance Center 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 Workload Types dialog box.

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

   Continue from step 3 of Define a performance test workload.

Create a test from the Create New Performance Test dialog box

1. From the Performance Center 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 Workload Types dialog box.

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

   Continue from step 3 of Define a performance test workload.

 

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 Performance Center 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 Workload Types dialog box.

Edit a test set

You can edit a test set.

1. Select the test to which the test set is assigned (Performance Center > 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 (Performance Center > 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 Performance Center tests:

1. From the Performance Center 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. Performance Center displays all tests and/or folders that contain the search string.
   Filter the tree for tests	Click Test to display Performance Center tests only. For test details, see Edit or run a test from the Testing page. Click to display all Performance Center 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 Performance Test Designer > Test Runs Trend view / Test Runs Trend tab Description. A description of the test. For details, see Performance Test Preview/Summary - 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 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.
   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 versions	Click the Versions tab to view details about previous versions. This includes the version number, time and date the test was last modified, the user who modified the version, and any user comments. To display read-only details for a test version, select a version in the grid, and click View Test. This provides additional details such as the Design Steps, Test Script, and Attachments. To check out a test, select a test in the versions grid and click Checkout. The selected version is checked out and the version number is increased by one. For more details, see Use version control to make changes to test assets. Note: This tab is available only if your project is version-enabled. For details on enabling version control, refer to the ALM Administrator Guide: Enabling and Disabling Version Control for a Project.
   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

Run a test

Select a test and click Run Test.

If the selected test is assigned to a single test set, then the Run Test dialog box opens. For details, see Run Test dialog box.

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

Back to top

Delete a test or test folder

Click to delete the selected test or folder from the test management tree.

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.

Back to top

See also:

• Design a performance test
• Manage scripts