LinkedIn
Copied!

Table of Contents

Migrating data to Deployment Manager 5

Version:

Only available versions of this content are shown in the dropdown

Use the migration assistant feature to safely migrate data, including roles, operator records, and pipelines to the version 5.x model.

Only users with the Super Admin role can perform pipeline, operator and roles migration.

Pipeline migration

  1. Import the Deployment Manager 5.x RAPs and restart the server.
  2. Log in to Deployment Manager using the DMReleaseAdmin operator.
  3. In the lower-left corner of the application, click the Operator icon, and then select Switch to Dev Studio.
  4. Open the operator record, and then update the default access group to SuperAdmin.
  5. Log out of the application, and then log in as the DMReleaseAdmin operator.
  6. On the Deployment Manager banner, click the info icon.
  7. Click Migration assistant.
  8. In the Pipeline Migration section, select the pipelines that you want to migrate.

    Migrate dependent pipelines first. View dependencies link provides details of all pipeline dependencies.
  9. Click Migrate.
  10. Confirm the pipeline migration by clicking Submit.
  11. When the migration is complete, the pipelines indicate the status of their migration:
    Success
    Indicates that the migration of the pipeline is successful. Expanding the row provides additional details on the pipeline migration.
    Fail
    Indicates that the creation of pipeline failed. Click View log to understand the cause of the failure.
    Not migrated
    Indicates that the pipeline is not migrated and the user can start the migration as required.
  12. If pipeline migration fails due to a loading error, ensure that the open ruleset in which pipeline case types are stored is present in the Deployment Manager 5.x application stack.
  • Stop all active deployments. Any deployments in progress are automatically aborted during the upgrade.

Migrating the operator

After a successful upgrade to the 5.x version, you can upgrade operators from the Migration assistant page. Operator migration migrates the existing roles to associate them with selected operators.

  1. On the Deployment Manager banner, click the info icon.
  2. Click Migration assistant.
  3. In the Operator Migration section, select the operators that you want to migrate.
  4. Click Migrate.
  5. Confirm the operator migration by clicking Submit.
  6. The operators table provides the status of operator migration:
    Success
    Indicates that the selected operator migration succeeded.
    Fail
    Indicates that either role or operator migration failed. For more information, you can click View upgrade logs on the Migration assistant page.
    Not migrated
    Indicates that the operator is not migrated and the user can start the migration as required.

    Operators that you migrate manually to version 5.x are not tracked by the operator migration feature.

Updating access group

If you are upgrading to version 5.x, ensure the PegaDevOpsFoundation:Administrators access group is updated to point to version 5 of the PegaDevOpsFoundation application. Perform this update for all candidates that are upgraded to PegaDevOpsFoundation 5.x.

Rolling back to Deployment Manager 4.x from 5.x

After a successful upgrade to the 5.x version, you can rollback your migration to a 4.x version if you choose.

  1. Ensure the candidate application points to a PDF 4 application and the PegaDevOpsFoundation:Administrators access group is pointed back to application PegaDevOpsFoundation 4.
  2. Change DMReleaseAdmin AccessGroup to PegaDeploymentManager:Administrator. This points your PegaDeploymentManager application to 4.x.
  3. If pipelines have already been migrated:
    • Log in to Deployment Manager 4.x portal. Go to the archived landing page, and manually activate the required pipelines.
    • Run the DeleteCreatedPipelines activity to clean up all pipelines created as part of the DM 5.x migration. This will ensure a smooth migration should you choose to return to 5.x.
  4. If operators were migrated to 5.x, you can roll them back using the UpdateDMOperatorsTo4x activity with parameter ALL.

Did you find this content helpful?

Have a question? Get answers now.

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