Running a Build Configuration

Follow this procedure to run a build configuration from the Build Administration Console.

To run a build configuration:

1. In the navigation pane of the Build Management tab of the Build Administration Console, expand Dimensions Projects and select the project containing the build configuration that you want to build.

2. Select the build configuration and on the toolbar click Run.

The Run Build wizard appears.

3. From the Dimensions Project list accept the default project/stream or select the project containing the configuration that you want to build.

4. (Only displayed if one or more baselines have been created from the project or stream) To build a baseline, select one from the list. If you do not want to build a baseline select <none>.

5. From the Build Configuration list select a build configuration for the project or stream.

6. From the Version list accept the default version of the build configuration (Latest) or select an earlier version.

7. From the Build Stage list select the deployment stage at which to build the targets. To build in a work area select <none>. You can only build a baseline in a work area.

8. From the Build Area list, select the build or work area where to build the targets.

9. If you are building in a work area do the following:

- From the Start search path from stage list select the stage where you want the search path to start.

- (Option not displayed for baseline builds) To download the files to the local work area before the build is executed select Download files to work area before each build.

- To apply the system date and time to files that are downloaded, select the option Apply system date/time to downloaded files.

10. Click Next.

11. To capture the build outputs and check them into Dimensions CM select the option Capture build outputs.

12. If you are checking in build outputs do the following:

- To check the build outputs into a different project or stream, from the Select Dimensions Project for output preservation list select a project or stream.

- To specify the requests to relate the build outputs to when they are checked into Dimensions, in the Provide Change Documents IDs field enter the request IDs in the following format (separate request IDs with a semicolon):

"QLARIUS_CR_44";"QLARIUS_CR_43"

13. Click Next.

14. On the Options page select build options:

- Audit area(s) before build: (not available for baseline builds) produces an audit report for the build areas associated with the Dimensions project/stream. The report is produced before the build.

- Execute clean-up script before build: runs the clean script (in the build configuration).

- Lock area(s) in search path: locks all deployment areas associated with the build and prevents other changes to these areas while the build is running. Only applies to work area builds.

- Rebuild all targets: rebuilds all targets. If you select this option the following option is also available:

• which are in the current stage: only builds targets whose source is at the current stage.

15. Enter additional options in the Other build options field. For details about build options see The Templating Language and Processor chapter of the Developer’s API Reference.

16. Click Next.

17. On the Targets page, select All targets or the specific targets that you want to build.

18. Click Next. A summary of the build command is displayed.

19. Click Run. If prompted enter the ID of the Dimensions user who owns the build area. You also need to enter and confirm their password.

The Build execution statuses dialog box opens. For details about evaluating the success or failure of a build, see Monitoring Builds.