Resolving conflicts when importing an archive using the command-line utility

Importing an archive might fail if the versions of rules and data instances in the archive conflict with those on the target. If you are using the prpcUtils command-line utility, you can configure the import options in the prpcUtils.properties file to resolve these potential conflicts.

To configure the import options, perform the following steps:

1. From the command prompt of your Pega Platform instance, navigate to the scripts/utils directory.
2. Open the prpcUtils.properties file. The comments in the file include information about valid values for each property.
3. Set the import.mode property value. The following table lists the valid values and when to use them.

   Property	Description
   Install	Use to import instances only if they are newer than those in the target system. Details of the instances that are ignored will be logged to file.
   Import	Use to import instances that are: Unavailable in the target Newer than the instances in the target Identical to the instances in the target When you import identical instances, the value of the import.existing.instance property determines whether to overwrite or skip the existing instances.
   Restore	Use to roll back a hotfix during an update.
   Hotfix	Use to overwrite older instances in the target with the newer instances in the archive.

4. Set the import.existing.instance property. The following table lists the applicable values, and when to use them.

   Value	Description
   Override	Set to import and overwrite the instances that already exist in different rulesets and versions.
   Skip	Set to skip the instances if already available on the target system.

   If you do not specify a value for the import.existing.instance property, the import operation will fail.

5. To start importing, run the command-line utility for your operating system with the import option:

   On Windows: prpcUtils.bat –import.

   On UNIX: prpcUtils.sh –import.

6. After you run the command-line utility, review the log file. If the log file lists any additional required actions, complete the actions and run the command-line utility again.

Open topic with navigation