Skip to main content

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

Configuring the source and target systems

Updated on August 25, 2021

Configure the source and target systems to migrate products from the command line.

  1. Set up users on the source and target systems. If you plan to migrate schema changes, the users on the source and target systems users must have product export (zipMoveImport ) and import (zipMoveExport) privileges, and SchemaImport privileges. The systems use these users for authentication, and to invoke the services.
  2. Add target systems on the source system by performing one of the following actions:
    • To add the systems from the user interface, go to step 3
    • Add target systems from the command line by using the addTarget action. For more information, see Command-line tool actions.
  3. Add target systems on the source system from the user interface:
    1. From the Application Explorer, navigate to the Data-Admin-System-Targets class.
    2. Click the class node type with the icon.
    3. Click Create to create a new instance.
    4. Enter a Short description and a Unique Name of Target System, and click Create and open.
    5. In the rule form, do the following:
      • Https?: Select this check box if you want to use HTTP with Secure Sockets Layer protocol for product migration.
      • Host Name: Enter a target server host name. This can be a machine name or an IP address.
      • Port Number: Enter a target server port number, such as 8080.
      • Context Root: Enter a target server context root name, such as prweb or prweb.war.
    6. Click Save to save the rule.
    Note: If you add target systems from the user interface, the system prompts you for the login credentials during migration.
  4. Configure the PegaDiagnosticUser security role on the source system:
    1. Create an instance of Data-Admin-System-Security as PegaDiagnosticUser on the source system. Specify the system granting the access as the source from which migration will be initiated.
    2. Add the same role and user to the tomcat-users.xml file:
      <role rolename="PegaDiagnosticUser"/>
      <user username="pega" password="pega" roles="PegaDiagnosticUser"/>
    3. Restart Tomcat for the changes to take effect. This user is used by the target system to authenticate and download the products for migration.
  • Previous topic Installing the command-line tool
  • Next topic Migrating an application or product by using the productMigration command-line tool

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