Configure Deployment Automation
To set up an integration with Deployment Automation, first prepare a Deployment Automation instance.
Note: If you have performed a clean installation of Dimensions CM with Deployment Automation and the demo schema, you can omit the steps described in this topic.
Step 1: Create application
Start with creating a Deployment Automation application that you can later map to a Dimensions CM product.
To create an application:
-
Log in to Deployment Automation.
-
Navigate to Management > Applications.
-
Click Create and create an application called QLARIUS.
Step 2: Create environments
After creating an application, create environments that you can later map to stages in the Dimensions CM Global Stage Lifecycle (GSL).
To create an environment:
-
In Deployment Automation, navigate to Management > Environments.
-
Click Create and create the following environments: SIT, QA, PRE-PROD, LIVE.
Step 3: Create pipeline
After creating environments, create a pipeline and add the SIT and QA environments to it.
To create and configure a pipeline:
-
In Deployment Automation, navigate to Management > Pipelines.
-
Click Create and create a pipeline called SIT_DA.
-
Open the pipeline you just created.
-
On the Pipeline tab, click Add/Remove Environments.
-
Add the SIT and QA environments to the pipeline.
Step 4: Add pipeline to application
After creating a pipeline, add the pipeline to the QLARIUS application.
To add the pipeline to the application:
-
In Deployment Automation, navigate to Management > Applications.
-
Next to the QLARIUS application, click the Edit icon.
-
From the Pipeline list, select the SIT_DA pipeline to add to the application.
Step 5: Add environment to application
After adding the pipeline to the QLARIUS application, also add the PRE-PROD environment.
To add the environment to the application:
-
In Deployment Automation, navigate to Management > Applications.
-
Open the QLARIUS application and select Environments. The pipeline you just added is displayed.
-
Click Add Environment and add the PRE-PROD environment to the application.
Step 6: Create component
Create an application component that you can use to deploy Dimensions CM baselines.
To create a component:
-
In Deployment Automation, navigate to Management > Applications.
-
Open the QLARIUS application and select Components.
-
Click Create and create a component called QL_BLN with the following settings:
-
For Source Config Type, select File System (Basic).
-
For Base Path, enter the path to the QLARIUS baselines.
-
Step 7: Create and design component process
Set up a component process to automatically download and promote baseline items.
To create and design a component process:
-
In Deployment Automation, navigate to Management > Applications.
-
Open the QLARIUS application and select the QL_BLN component.
-
On the component's page, select the Processes tab.
-
Click Create and create a process called AppDownloadProcess. For the Process Type, select Deployment.
-
After saving the process, open it.
-
In the Tools pane, navigate to Repositories > Artifact > DA.
-
Drag the Download Artifacts step onto the design space.
-
Specify the step's properties.
-
Connect the step to the Start and Finish steps.
-
Save the component process.
Step 8: Create and design application process
Set up an application process to run an installation.
To create and design an application process:
-
In Deployment Automation, navigate to Management > Applications.
-
Open the QLARIUS application and select the Processes tab.
-
Click Create and create an application process called CompProcessInstall.
-
After saving the process, open it.
-
From the Tools pane, drag the Install Component step onto the design space.
-
Specify the step's properties:
Property Description Name Enter a name for the process: CompInstall. Component From the Component list, select QL_BLN. Component Process From the Component Process list, select AppDownloadProcess. -
Connect the step to the Start and Finish steps.
-
Save the application process.
Step 9: Create resource
Create a resource and map it to a Deployment Automation agent.
To create a resource:
-
In Deployment Automation, navigate to Management > Resources.
-
Click Create and create a resource called daAgent.
In the Agent field, select the Deployment Automation agent installed on the host machine.
Step 10: Add resource to environment
After creating a resource, add the resource to the QA environment you created earlier.
To add the resource to the environment:
-
In Deployment Automation, navigate to Management > Resources.
-
On the Resources page, select Environments.
-
Click the QA environment name to select it.
-
Select the Resources tab.
-
Add the daAgent resource.
Step 11: Map component to resource
Map the QL_BLN component in the QA environment to the daAgent resource.
To map an application component to a resource:
-
In Deployment Automation, navigate to Management > Applications.
-
Open the QLARIUS application and select the Environments tab.
-
Click the QA environment name to select it.
-
From the pop-up menu, select View Details.
-
Select the Component Mapping tab. The QL_BLN component is displayed as mapped.
-
Click Actions and select Add a Resource to add the daAgent resource.
Next steps: