Baselines and Deployment

You can promote, demote, or deploy one or more baselines in relation to the associated deployment areas for a project/stream.

For details, see the Deployment Guide.

For details of how to create deployment areas, see the Process Configuration Guide.

Baseline Consistency Checks


Baseline consistency checks enforce additional verifications on the requests that are used to create a revised baseline (CRB) or a request template baseline (CBL). These checks ensure that:

Enabling the Baseline Consistency Checks

To enable baseline consistency checks on your Dimensions CM server installation:

  1. Add the following variable to the configuration file %DM_ROOT%\dm.cfg on the server:


  3. Restart the Dimensions listener.

What do the Checks Validate?

When a new revised baseline or request-driven baseline is created, the checks described below are run to validate the consistency of the changes used to create the baseline.

Ensure all Requests are at an Implemented State

To be accepted for use, any requests that are provided as an input when a new baseline is created must be at a frozen or closed state. Any requests that are still under work or being tested are detected and rejected.

Ensure all Requests are Owned by the Correct Project or Stream

Any requests that are provided as an input when a baseline is created must be one of the following:

Requests related to a different project or stream are invalid and will be rejected.

Ensure Requests are not being Re-Used

If you attempt to create a new baseline using a request that has already contributed content to a previous baseline, that request is rejected. This check, and others described below, consider the baseline being created as well as the chain of baselines that led to the current one.

For example, consider the following scenario:


 The creation of BLN003 fails because the consistency checks find that CR_21 was used in a previous baseline in the chain of baselines that leads to the one being revised (BLN003).

Ensuring Requests provide a Consistent Set of Changes

To ensure that the request list represents a consistent and complete set of changes, the consistency checker validates the requests and their items against the following criteria to check that there are no requests missing:

Filtering of Item Revisions

To ensure that only relevant items are considered in the consistency check, the following additional criteria are used to filter out any items that are irrelevant:

Overriding the Consistency Checks

To override any issues identified by the consistency checks and to force the baseline to be created, add the /FORCE qualifier to the command that you submit. This qualifier generates warnings for consistency checks that are violated, however the baseline is created. Only users with the privilege that allows them to override process checks can run this command.


Example 1: Ensuring a Consistent Set of Changes


The change made to file2 (when a change was also made to file1) will be missing unless CR_10 is included. The consistency checks warns that the baseline cannot be created only using CR_11 as it will be missing the dependent change made using CR_10.

Example 2: Refactoring Changes (Moves, Renames, and Deletions)


To get a consistent set of changes the new baseline should be created with reference to CR_22 and CR_23. If you run the following create revised baseline command:


the consistency checks will detect that request CR_22 is missing and the command will fail.

If you re-run the baseline command and specify CR_22 and CR_23, the baseline will be created successfully because the changes referred to by CR_22 (on which CR_23 is dependent) are now included.