Skip to main content


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

Importing the application bundles

Updated on December 20, 2021

This content applies only to On-premises and Client-managed cloud environments

Import the application bundles from the distribution media.

  • Rules/PegaCDH_Core_0805.zip. This contains the Pega Customer Decision Hub framework application which consists of schema changes, JAR files, and rulesets required by Pega Customer Decision Hub that are not shipped separately.
  • Rules/PegaCDH_Upgrade_0805.zip. This contains the upgrade version of the Pega Customer Decision Hub implementation application. This version will not overwrite configuration settings that may have been made to your existing implementation application.
Pega Customer Decision Hub Update Guide
  1. On IBM Db2 environments, ensure that ownership of the MKT_INTERACTION_DETAIL and MKT_COMMUNICATION_HISTORY views is attributed to the ExternalMKTData schema owner. For example, if that user is MKTDATA:
    1. Transfer ownership of VIEW MKTDATA.MKT_INTERACTION_DETAIL to user MKTDATA PRESERVE PRIVILEGES.
    2. Transfer ownership of VIEW MKTDATA.MKT_COMMUNICATION_HISTORY to user MKTDATA PRESERVE PRIVILEGES.
  2. On IBM Db2 environments, run the ResourceKit/upgrade/DB2/upgrade_pre_import.sql script by doing the following tasks:
    1. If your database schema is different from PegaDATA, edit the ResourceKit/upgrade/DB2/upgrade_pre_import.sql script and, if different, change all references of PEGADATA to refer to your database schema.
    2. Log in to your database client as a user who can create and drop objects in your database schema.
    3. In your database client, run the upgrade_pre_import.sql script.
  3. Log in to Pega Platform as [email protected].
  4. To open the Import wizard, in Dev Studio, click ConfigureApplicationDistributionImport.
  5. Click Choose File, browse for the Rules/PegaCDH_Core_0805.zip file from your distribution media, and follow the wizard instructions.
    Important:

    When you import the Rules/PegaCDH_Core_0805.zip, errors related to library compilation appear in the log file. To resolve them, log out and restart the application server, then continue the import process.

    Make sure that the check box Automatically run Upgrade Application Schema when import is complete on the Schema changes page is checked before you proceed with the Rules/PegaCDH_Core_0805.zip bundle import.

    Caution: Do not select the Enable advanced mode to provide granular control over the import process check box. The check box must be cleared to ensure that you import all components.
    Result: The wizard identifies differences between the database schema of your current system and the schema of Pega Customer Decision Hub 8.5.
  6. Based on the review of the database policies and application permissions that are used by your Pega Platform upgrade, perform the appropriate step:
    • Select the Automatic check box and complete the wizard.
    • Select Manual and complete the following steps:
      1. Click View/Download DDL SQL. This produces a text file containing Data Definition Language (DDL) statements for the needed changes.
      2. Save the DDL file and deliver it to a database administrator to make the required changes. Depending on your organization’s policies, database administrators might need to review these DDL files to determine what changes will occur prior to applying the DDL to your database.
      3. After the database administrator has applied the DDL, repeat the Import wizard steps.
    If there are errors that you cannot resolve, post your questions to the Pega Product Support Community. For more information about the database policies and application permissions, see Prerequisites.
  7. To import the Rules/PegaCDH_Upgrade_0805.zip file, repeat steps 3-5.
  8. On IBM Db2 environments, run the ResourceKit/upgrade/DB2/upgrade_post_import.sql script by doing the following tasks:
    1. If your database schema is different from PegaDATA, edit the ResourceKit/upgrade/DB2/upgrade_post_import.sql script and, if different, change all references of PEGADATA to refer to your database schema.
    2. Log in to your database client as a user who can create and drop objects in your database schema.
    3. In your database client, run the upgrade_post_import.sql script.
  9. Optional: For best performance and initial user experience, run the Static Assembler utility to pre-assemble the rules in the application. For more information, see Preassembling rules in an application by using the Static Assembler utility.
  10. Apply the required hotfixes. For more information, see Pega Customer Decision Hub hotfixes page.

    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.

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

    Close Deprecation Notice
    Contact us