About Product Migration

Application migration can be done using a command line utility or wizard.

About the command line utility

The Product migration command line utility is an enhancement to the existing UI based migration from within PRPC. This utility is intended to give ability to users to perform migration of multiple products (RAPs) to multiple targets and also get a more granular status of the migration process.

This is a standalone utility and doesn’t require engine to start up. Instead it uses services exposed from PRPC to communicate with both source and target ends of migration. This utility is available from release PRPC v7.1.

Using the command line utility

 Product Migration Command Line Utility for details on how to use the command line utility.

About the Wizard

The Product Migration Wizard simplifies the management of rule assets across PRPC systems. After specifying the appropriate packaging information through a Rule-Admin-Product instance, this wizard eliminates the need to:

• Manually generate rule archive files.
• Manually move rule archives between systems.
• Manually perform imports on each of the target PRPC systems.

This wizard creates a work item with prefix pxMigReq-. To find open and resolved wizard work items, select > Application > Tools > All Wizards. There is also a command line tool that you can use to perform these actions.

Before using the wizard, do the following:

• In your source system, verify that the PegaDiagnosticUser security role is defined for your PRPC server node. Also confirm that an instance of the Data-Admin-System-Security class exists with this security role as the key. The user and password information must match the ones specified by the Web server console for this security role. Normally, this security role is configured during installation of your PRPC server. For more information, see the Installation Guide for your platform.
• Verify that v5.4 or later is installed on your target systems.
• Validate the connections between the source system and target systems.

Starting the wizard

Select> Application> Distribution> Migrate Product to start the Product Migration wizard and create a Migration Request cover work item; the resulting work item ID has the prefix pxMigReq. The Step 1: Products and Targets form appears.

If your system contains unresolved migration requests, select one from the worklist that appears (see Managing requests below).

Creating and submitting a migration request

In the Step 1 form, specify the product and version. Then identify one or more target systems.

1. Click Next>> to move to the Step 2: Authentication wizard form. Enter the ID and password needed to authenticate access to each of the target systems.
2. Click Finish to submit the request and begin the migration process, which includes:
   • Creating the product ZIP file, which uses the following naming convention:<product name _version number[-patch number] >. For example: MyProd-Classgroup_01-01.zip or MyProd-Classgroup_01-01-99.zip.
   • Creating work item IDs for each of the destination systems, using a prefix of pzMigDest.

When you submit the request, the source system creates a ZIP archive file. It also creates a covered work item for each target system. The process then attempts to make a connection to each target system and place the ZIP file on its ServiceExport directory.

• If the connection succeeds and the file is successfully loaded onto the server, the work item is resolved.
• If the connection fails or the file is not loaded due to system error, the work item status is Pending. You can either retry the connection or cancel the connection attempt, which withdraws and resolves the work item.

Saving target systems

Rather than having to re-enter the host name, context root, and port number each time you submit a migration request, you can create a list of saved target systems. This allows you to select the systems you want to export to.

You add the target systems to the list by creating instances of the Data-Admin-System-Targets rule. To create a new System Target instance:

1. Using the Application Explorer, navigate to the Data-Admin-System-Targets class.
2. Click the new instances icon on the toolbar.
3. In the New form, enter a name for the target system and click Create.
4. In the rule form, enter:
   • PRPC server name (machine name or IP address)
   • Server port number, such as 8080
   • Server context root name such as prweb or prweb.war
5. Save the rule.

The information displays in the Specify Target Systems list in the Step 1. Product and Targets form.

Managing requests

• If you have created a migration request and exited the wizard and did not click Cancel, the request appears as unresolved item in a worklist when you start the wizard again. Select an item to open the Product and Targets form and resume the migration request. Values you may have entered before exiting are not retained.

  If you created a new target system rule instance after the original request was created, the system does not appear in the Specify Target Systems list.

• To delete a request in the list, click the item to open the wizard form. Then click Cancel to withdraw the request and resolve it.
• To create a new request from the list, click New. The Step 1. Select a Product form appears.

About the Product Migration Command Line Tool

You can also perform these actions and more using the Product Migration Command Line tool. This is also useful for scripting commonly used actions.

About Product rules About the Application Packaging wizard Import Archive — Completing the Import Zip file option About the Package Work wizard

Tools — System