Skip to main content

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

Selecting the product and target systems

Updated on July 8, 2022

Select the product and target systems.

Before you begin:

Specify the application or product to migrate and the target systems.

Note: The source system and target system must be in the same major Pega Platform version. For example, you cannot migrate if the source is in PRPC 6.x and the target is Pega 8.x.
  1. Do one of the following:
    • Migrate a product by entering values for the following fields.
      • Product: Select an available product. These are products created in the Product rule form or in the Application Packaging wizard.
      • Version: Select the correct product version.
      • Patch: Optional. Select an available product patch.
    • Migrate an application by entering values for the following fields:
      • Application: Select an available application package. These are application packages created in the Product rule form or in the Application Packaging wizard.
      • Version: Select the correct application version.
  2. To use an existing .zip file, select Use existing .zip file. If you changed the product after you packaged the .zip file, the existing .zip file will not include the changes.
  3. To download an application or package without importing, select Download only. For example, you can download an application as a backup or archive copy.
  4. Select the target system. Do one of the following:
    • Select an existing target system.
    • Add a target by doing the following:
      1. Click the plus sign to add a row.
      2. Complete the following fields:
        • Unique name: Enter a short unique name to identify this target.
        • URL: The URL for the target system. Either cut and paste the URL into this field, or enter the entire URL of the target system. Include the port number and the context root.
        • User name: Verify that the auto-populated user name is correct.
        • Password: If you changed the auto-populated user name, enter the password for the new user name.
  5. Manage saved target systems.
    • Delete a target system by clicking the trash can icon.

    • Edit a target system by clicking the Open icon and editing the target system connection details and history.

  6. Click Migrate.
What to do next: The source system creates the following items:
  • A archive file. The naming convention is <product name _version number[-patch number]>, for example, or
  • Covered work item IDs for each target system. These IDs include the prefix pzMigDest.
  • Previous topic Starting the Product Migration wizard
  • Next topic Reviewing command-line migration logs and work item status

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us