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.

  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.
    If you do not specify a value for the import.existing.instance property, the import operation will fail.
    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.
  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.