Build Verification Suites

This section describes how to create a build verification suite, which enables you to test the status of a particular build of your application under test.

Note: The Build Verification module is available only for projects that have the ALM Lab extension enabled.

Build Verification Overview

The Build Verification module enables you to define a suite of automated functional test sets bundled together with a single performance test (called a build verification suite). When run together, the build verification suite checks the overall status of your build.

When defining a build verification suite, you can select an AUT environment configuration which represents the build on which ALM checks the status. For details about AUT environment configuration, see Lab Resources.

If your system is integrated with Continuous Delivery Automation (CDA), you can instruct ALM to provision machines and deploy the build on a dynamic environment. For details on the integration between ALM and CDA, see Lab Resources.

Build verification suites are a key component in ALM's Continuous Delivery solution. They facilitate an automated, end-to-end deployment and testing framework that makes application development more efficient, reliable, and quick.

For details about how build verification suites can be used as part of this process, see Deploy and test your application in ALM.

Back to top

Create and run build verification suites

Create a build verification suite to include all related Functional test sets and run the suite to test the status of your build.


In the Test Lab module, create the functional test sets that will be included in the build verification suite. For details about creating test sets, see Create test sets.

To create and run a build verification suite:

  1. On the ALM sidebar, under Testing, select Build Verification.

  2. Create a build verification suite.

    1. On the ALM sidebar, under Testing, select Build Verification.

    2. Click the Build Verification Suites folder and on the toolbar click the New Build Verification Suite Folder button.

    3. Click the New Build Verification Suite button and enter a name for your build verification suite. Click OK. The build verification suite is added to the tree.

      Tip: Give the suite a meaningful name. This can be derived from the purpose of the build you are checking. For example: ABC Application - Staging Build.

  3. To add Functional test sets to the suite, select the suite and click the Functional Test Sets tab.

    Click Select Test Sets to add Functional test sets to the suite.

  4. Run the suite.

    Use one of the following methods:

    • Run the suite immediately. On the Build Verification Suites page toolbar, click Run. The Run Build Verification Suite dialog box opens, enabling you to select immediate timeslot for the suite. For details, see Run tests in a Functional test set.

    • Run the suite at a specified time. Reserve a future timeslot for the suite to enable you to run it at a later date. For details, see Timeslots.

  5. View the test run results.

    For each build verification suite that runs, ALM generates an Execution Report. The Execution Report provides general details about the suite, overall information per test set, as well as drilled-down run information for each individual test within the suite. For details, see Execution Report Page.

    If you ran the suite from within the Build Verification module via an ad-hoc timeslot, you can view the Execution Report details in real time. Irrespective of which method you use to run the suite, you can access the report by clicking the Last Run Report button on the Build Verification Suites page toolbar.

Back to top