Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Quick-start guide for Deployment Manager on-premises and client-managed cloud

Updated on February 4, 2021

This guide summarizes all of the required steps for getting started with Deployment Manager for on premises and client cloud deployments. For customers with familiarity with Deployment Manager and the Pega Platform it can act as a checklist for quickly setting up a new Deployment Manager implementation.

Note: Determine two passwords that will be used throughout these instructions for the following operators:
  • DMReleaseAdmin
  • DMAppAmin

Import the Deployment Manager applications

On the orchestration environment

  1. Import the PegaDevOpsFoundation RAP.
  2. Import the PegaDeploymentManager RAP.
  3. Restart the orchestrator after imports are completed.

On each candidate environment

  1. Import the PegaDevOpsFoundation RAP.
    • PegaDevOpsFoundation 4.8.4 for Pega Platform 8.1 - 8.4
    • PegaDevOpsFoundation 5.1 for Pega Platform 8.5.2 or higher.

See Installing or upgrading Deployment Manager 5.x for a more detailed installation guide.

Configure the orchestration environment

  1. Log in to the orchestration environment as an administrator.
  2. Enable the DMReleaseAdmin operator and set the password.
  3. Open the DMAppAdmin authentication profile and set the password.
  4. Log in as DMReleaseAdmin.
  5. Navigate to Settings General settings.
    1. Ensure that the orchestrator URL is correct.
    2. Click Generate client secret.
    3. Download the client secret.
    4. Click Update authentication profiles.
  6. Upload the JKS keystore on DMKeyStore rule. For information on keystore and truststore setup, see Securely authenticating in Deployment Manager.

See Setting up the orchestrator for more information on configuring the orchestrator.

Configure the candidate environments

  1. Log in to each candidate environment as an administrator.
  2. Enable the DMAppAdmin operator and set the password.
  3. Open the DMReleaseAdmin_oAuth2 authentication profile and set the client secret, access token endpoint, and revoke token endpoint downloaded from the orchestrator.
  4. Upload the JKS keystore on DMKeystore. For information on keystore and truststore setup, see Securely authenticating in Deployment Manager.
  5. Update the alias and password for the keystore on DeploymentManagerClientJWTProfile.

See Setting up candidate environments for more information on configuring the candidate environments.

Configure the development environment

  1. Log in to the dt1 environment as an administrator.
  2. Update the OrchestratorURL Dynamic System Setting to the URL of the DevOps environment. The URL should end in /prweb.
  3. Open the application record with which you want to manage with a Deployment Manager pipeline, and set PegaDevOpsFoundation version 5 as a built-on application

See Setting up candidate environments for more information on configuring the candidate environments.

Configure the application

  1. The application that is being promoted by a Deployment Manager pipeline should be built-on the latest version of the PegaDevOpsFoundation application.

See Configuring an application for more information on configuring the candidate environments.

Create your first pipelines

  1. Log in to the orchestration environment as DMReleaseAdmin.
  2. Click New in the top-right corner and choose Deployment pipeline.
  3. On the first screen, enter the following information as it applies to your application:
    1. Application name and version
    2. Access group
    3. Product name and version that defines your entire application.
    4. Pipeline name
  4. Click Next to progress to the Environment details screen and enter the following information:
    1. Environment URL and Authentication profile for each environment you want included in the pipeline.
    2. Development repository
    3. Production repository (can be the same as development)
  5. Click Next to progress to the Model pipeline screen and press Create to create the pipeline.

See Creating pipelines for more information on creating pipelines.

Test and Execute the pipeline

  1. In the top right corner of the rule form, in the action menu, diagnose the pipeline to ensure your set up is valid.
  2. Click Start deployment to move your newly updated application through the pipeline.
    Note: This active deployment promotes changes from development to higher environments, as defined in the pipeline.

You are now ready to learn more about customizing Deployment Manager pipelines.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us