Integrate Dimensions CM and Deployment Automation

This topic provides instructions on how to set up the integration with Deployment AutomationDA.

Configure Dimensions CM to use DA

To use Deployment Automation, modify the Dimensions CM dm.cfg configuration file.

Note: If you do a clean install of Dimensions CM with DA, you do not need to change the dm.cfg configuration file. These steps are completed automatically when you run the installer. For details, see Install Dimensions CM.

To configure Dimensions CM to use Deployment Automation:

  1. Open the CM configuration file:

    %DM_ROOT%/dm.cfg

  2. Add the following variables:

    Variable Description
    DM_SDA_URL

    Specifies the URL of the DA server, for example:

    DM_SDA_URL %DM_WEB_URL%/da

    Tip: Multiple Dimensions CM servers can use the same DA server.

    DM_SDA_NOTIFY_TO_USER

    Specifies a Dimensions CM user ID that DA will use to notify CM about the success or failure of automation runs, for example:

    DM_SDA_NOTIFY_TO_USER notifyusr

  3. Save changes to the dm.cfg file.

  4. Register the notification user account password in registry.dat specifying DM_SDA_NOTIFY_TO_USER (not a real user ID) as the first parameter:

    Copy code
    dmpasswd DM_SDA_NOTIFY_TO_USER -add -pwd <password>
  5. Restart the Dimensions CM Listener.

Back to top

Authenticate between Dimensions CM and DA

If you use single sign-on (SSO) to authenticate between Dimensions CM and DA, verify that the CM users who are performing configuration and deployment have privileges in DA to list applications, components, and processes and to run automations.

SSO between CM and DA is enabled by default if you do a clean install (not an upgrade) of both products at the same time.

If you are not using SSO, configure the integration to authenticate through the DA service account.

To set up the authentication through the DA service account:

  1. Open the Dimensions CM configuration file:

    %DM_ROOT%/dm.cfg

  2. To specify the service account user name, which will be used to authenticate all integration actions, add this variable:

    Copy code
    DM_SDA_USER <DA user ID>
  3. Save changes to the dm.cfg file.

  4. Register the service account password in registry.dat specifying DM_SDA_USER (not a real user ID) as the first parameter:

    Copy code
    dmpasswd DM_SDA_USER -add -pwd <sda_user_password>
  5. Restart the Dimensions CM Listener.

Back to top

Map CM products to DA applications

After configuring the dm.cfg file and setting up authentication, map your CM products to DA applications.

You can mix deployment models in the same base database. Some Dimensions CM products can use Dimensions deployment, while others can use DA.

To map a CM product to a DA application:

  1. Log in to the Dimensions CM administration console.

  2. Click Product Definitions.

  3. In the navigation area select a product.

  4. On the Product Details tab, click Edit.

  5. For Automation Application, select an DA application.

    A DA application brings together all the components that need to be deployed at the same time.

  6. For Default Process, select a default DA application process.

    An application process defines how to deploy, install, or interact with components. A process typically contains a sequence of interdependent steps and may include the automation of multiple components and complex logic based on conditions.

  7. Click OK.

Back to top

Map the global stage lifecycle to DA environments

After you have mapped CM products to DA applications, map stages in the Dimensions CM Global Stage Lifecycle (GSL) to DA environments or a pipeline.

When you promote a baseline to a stage, the application process runs as follows:

  • Environment: in the mapped DA environment.

  • Pipeline: in the first DA environment in the pipeline.

To map the GSL to a DA environment or pipeline:

  1. Log in to the Dimensions CM administration console.

  2. In Areas and Deployment click GSL.

  3. Select the stage you want to map to DA.

  4. On the toolbar click Properties.

  5. For Deployment automation to, select an option:

    No Automation Do not map this stage to DA (automation will not happen when promotions are made to this stage).
    Pipeline Select a DA pipeline. A pipeline is a sequence of environments where an application process will run.
    Environment Select a DA environment where the deployment automation process will run when promoted to the corresponding stage.
  6. Click OK.

Back to top

See also: