Skip to main content

Resolving conflicts when importing an archive by using the productMigration command-line tool

Suggest edit Updated on May 11, 2022

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.
    PropertyDescription
    ImportThis is the default behavior. Use to insert new instances and update existing instances at the same time.
    InstallUse only to insert new instances and log primary key violation messages without updating existing instances.
    HotfixUse to insert new instances and overwrite older instances in the target with the newer instances in the archive.
  4. For imports, set the import.existing.instance property to specify the behavior when an instance exists in both the target and the archive and the ruleset or ruleset version of the rule has changed. 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 and the ruleset or ruleset version of the rule has changed, the import operation fails with an exception.
    ValueDescription
    SkipThe import does not update the instance in the target database.
    OverrideThe import updates the instance in the database.
  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.
  • Previous topic Migrating an application or product by using the productMigration command-line tool
  • Next topic Reviewing migration results
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us