This article is now out of date. The latest content regarding Deployment Manager FAQ can be found in Pega community at the following link: https://community.pega.com/knowledgebase/articles/devops/86/frequently-asked-questions-faqs

Please refer to the link above for the most up-to-date content.

-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Here is a list of all the general FAQ and troubleshooting guides. This will be a master list that will be updated as new FAQs are added here over time.

Frequently Asked Questions

• Installation and configuration
  • Deployment Manager Versions and Installation
    • What versions of the Pega Platform is required by Deployment Manager?
    • Can cloud customers directly download new releases from Pega Marketplace?
    • Where can I get older versions?
    • What is the preferred configuration for installation?
    • Can my candidate environments exist in different VPCs?
    • Can a single system serve as both a development system and an orchestrator?
    • What is the recommended size and configuration for the orchestrator instance?
    • How should operators be configured on the orchestrator?
  • Application Structure and Configuration
    • Should I use Deployment Manager as a built-on application?
    • How should my application product rule be configuration?
    • How do I prevent Test Cases from being migrated to production?
    • How to deploy a new application?
  • Pipeline Modelling
    • How can I support more than four stages in a Pipeline?
    • Why can I only have one deployment per stage?
    • Can I have a pipeline progress to a stage only after manual approval?
    • Can we alter the out of the box case workflow of a Pipeline?
  • Artifacts and Repositories
    • Can I use Deployment Manager without hosting an artifact Repository?
    • Why are there two repositories being used in the pipeline?
    • Are custom repository types supported?
    • Is the Pega repository type supported?
    • Is the defaultstore repository supported?
    • What repository should I use on Pega Cloud?
    • Can I use a Source Code Manager (SCM) as a repository?
    • How are artifacts generated over the course of a Deployment?
  • Continuous Integration and merging branches
    • What is the correct way to make changes to non-rule-resolved rules and data?
    • If my target application is locked, how can a developer use branches?
    • How can I prevent my development branches from being migrated to higher environments?
  • Other
    • Are schema changes supported through a pipeline?
    • How do rollback features work and when should I use them?
    • What can I do with the Deployment Manager Rest API?

• How to guides
  • Installation
    • Migrating orchestrator environments
  • Submitting changes through Branches
    • Support for localization rulesets in branches
    • The correct way to make changes to non-rule-resolved rules and data
  • Deployments
    • Managing application dependencies
    • Managing dependent data
    • Migrating test cases separately
  • Running tests
    • Running Scenario Tests using BrowserStack
    • Running Scenario Tests using Crossbrowser Testing
    • Running Scenario Tests using Selenium Grid
  • Other
    • How to access developer portal (Dev Studio) from Deployment Manager
    • Integrating with external CI Tools as an alternative to Jenkins tasks

• Troubleshooting Guides
  • Troubleshooting connection issues between Orchestrator and Candidate system, or vice versa
  • Troubleshooting email configuration
  • Troubleshooting errors on the Merge Wizard
  • Troubleshooting trigging the CI process using branch publish (deprecated as of version 4.4)
  • Debugging Jenkins integration with Deployment Manager

• Common Problems
  • Pipeline Modelling
    • Pipeline is not editable as one of the previous deployments is in unresolved state but on the UI build completion is not visible.
    • Unable to see existing pipelines in the landing page.
  • Task Specific
    • Guardrail compliance Error is observed while migrating RAP. Error says "Error in retrieving guardrail compliance score. Unauthorized access for the given parameter ID"
    • Branch Review task is failing
  • Continuous Integration and merging branches
    • Merge request shows an invalid password error when trying to merge
    • Stuck merge requests
    • Merge requests fail, indicating that a branch could not be found
    • When I merge I see “Insufficient privilege” error in the merge requests modal
    • Branch merge task fails with an error
    • Merge shows an internal error even though merge was completed
  • Pipeline Diagnostics and Intersystem Communication
    • My 8.1 Orchestrator is very slow or unresponsive on cloud.
    • On Pega Platform 7.4 my orchestration system fails to connect to managed systems.
    • Pipelines and diagnostics failing due to outdated Orchestrator URL
    • After upgrade deployment manager to 4.5, repository diagnostics is failing with error 'The artifact cannot be read from the repository'.
  • Other
    • Unable to add Developer Portal access to DM Administrator

Other resources

• Comparing Deployment Manager vs open DevOps tools such as Azure DevOps, Jenkins, Bamboo and others
• Ask the experts session on Deployment Manager with Linoy Alexander
• Ask the experts session on DevOps & Deployment Manager with Ryan Feeney