Running server test assets
You can run tests that are listed as server test assets created in HCL 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 a Web UI test in Test Hub. See Recording a Web UI test.
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 based on the type of test assets that you want
to run:
- SUITES
- TESTS
- ADVANCED
-
Identify the Server Test 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 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:
- 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
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.