Running server suite assets

You can run a test suite that is listed as server suite asset created in IBM® DevOps Test Hub (Test Hub).

Before you begin

You must have completed the following tasks:

Read and completed the tasks mentioned in Prerequisites to running tests, if they apply to the test that you want to configure for a run.
Read and completed the tasks mentioned in Test run considerations for browser-based Web UI tests, if you want to run tests that use Chrome or Edge browsers.
Read and completed the tasks mentioned in Considerations for using a remote Kubernetes cluster, if you want to use a remote Kubernetes cluster as a location to run the test.
Completed the Xray integration, if you want to export the test results to a Jira issue in your Xray project in Jira. See Integration with Xray test management for Jira.
Ensured that you are assigned a role as a Member or Project Creator in the team space. See Managing members and their roles in a team space.
Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
Created a project in your team space in Test Hub. See Creating a project.
Added the remote Git repository that contains the test resources to the project. See Adding repositories to a server project.
Created Web UI tests, and then created a test suite in Test Hub. See Recording a Web UI test and Creating a suite.

Procedure

Log in to Test Hub.
The Projects page of the initial team space is displayed.
Open the project that contains the test assets, and then click Execution.

Select the branch of the repository that contains the test assets.

The test assets that are contained in the selected branch of the repository are displayed in the following tabs on the Execution page:


Tab	Description
SUITES	Lists all suites, Compound Tests, JMeter tests, JUnit tests, Postman tests, Rate Schedules, Selenium tests, or VU Schedules that are in the selected branch of the repository.
TESTS	Lists all API tests, functional tests, performance tests, or server test assets that are in the selected branch of the repository.
ADVANCED	Lists all assets that are displayed when custom filters are applied for assets in the selected branch of the repository.

Select one of the following tabs to select the test suite that you want to run:
- SUITES
- ADVANCED
The test assets in the selected tab are displayed.
Identify the server suite asset that you want to run by scrolling through the list, searching for the test, or applying a filter.
Clicking the test name displays the Details panel. You can view the details of the test asset such as the description, the branch in the repository that contains the asset, the Git details, and the details of the commits to the repository. You can also view the history of the test runs for the specific test under the History tab of the Details panel.
Click the Execute icon in the row of the identified test asset.
The Execute test asset dialog is displayed.
Select the version of the test resources that you want to run in the Version field.
Click Schedule and select the time if you want to schedule the test run. Else, skip the step.
Enter a label for the test run that helps you to identify the test on the Results page.
Follow the instructions to select a browser:
1. Click the ENVIRONMENT tab, if it is not already open.
2. Select an environment from the list that is available for the test run from the Environment drop-down list.
  The variables and profile overrides in the selected environment override the values defined in the test when you run a test or suite.
3. Select a browser or device profile for the test run from the Browser drop-down list.
  If you do not specify the browser, the browsers that are configured for individual tests in the test suite are used for the test run.
Optional: Click the DATA SOURCES and select a dataset tab if you are running a test asset that contains datasets.
Optional: Click the VARIABLES tab, and then add or upload variables if the test requires a variable that must be passed to the test at the test run time.
Optional: Click the LOCATION tab, and then select the agent that you have added in the Override field.
After selecting the agent, if the specified browser is not available to the agent, Test Hub displays a warning indicator in the Environment tab.
Click the RESULTS tab and select an option if you want to export the test results to a Jira issue in your Xray project in Jira.
You must have set up Jira as a change management system and configured the Xray integration to export the results.
Click Advanced to enter any of the following values that must be passed to the test run if they are applicable for the test:
- JVM Arguments
- Program Arguments
- Environment Variables
Click Execute.
The test run is initiated.

Results

You have run a server suite asset that is created in Test Hub.

What to do next

You can perform any of the following tasks:

Stop the test run at any point after the test run is initiated from the Execution page. See Stopping test runs.
Cancel a scheduled test run from the Execution page. See Canceling scheduled test runs.
View all the states of the test asset by clicking the Show in the Progress page icon for the test asset for which you started or scheduled the run. See Viewing the state of test assets.
View the progress of the test from the Progress page. See Viewing the progress of running test assets.
View the results, reports, and logs of the test from the Results page after the test completes the run. See Test results.