Skip to main content


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

Completing the prerequisite tasks

Updated on December 20, 2021

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

Pega Customer Decision Hub Update Guide
Before you begin:
  1. Ensure that there are no open change requests in your application, including requests created through Revision Management and through Pega 1:1 Operations Manager.
    Caution: If any change requests are in status other than Resolved-Completed or Withdrawn during the upgrade, they may fail.
  2. Ensure that any existing responses to adaptive models are updated.
  3. Run the Pre-Upgrade Check component to assess if your application is ready for the upgrade. If the check reports any issues, resolve them.
  4. Ensure that you can stop and start the application server.
  5. Before starting an update, and before backing up your system, review the database policies and application permissions that are used by your Pega Platform update. Determine whether the application is permitted to update the database automatically or if you must generate the database scripts that your organization will use to manually make schema changes.
  6. If you are upgrading from Pega Marketing 7.13, 7.21, 7.22, 7.31, or 7.4, apply the required upgrade hotfix for the version you are upgrading from.
    • Pega Marketing 7.13 - HFix-48983
    • Pega Marketing 7.21- HFix-49813
    • Pega Marketing 7.22 - HFix-50020
    • Pega Marketing 7.31- HFix-46621
    • Pega Marketing 7.4 - HFix-67467
    You can request the upgrade hotfixes from Global Customer Support.
  7. Run the activity in the upgrade hotfix, depending on the version you are upgrading from:
    • Pega Marketing 7.13 - UpgradePMToSeamless
    • Pega Marketing 7.21- UpgradePMToSeamless
    • Pega Marketing 7.22 - UpgradePMToSeamless
    • Pega Marketing 7.31- UpgradePMToSeamless
    • Pega Marketing 7.4 - UpgradePMTo74CloudReady
  8. If you are upgrading from Pega Marketing 7.13 and your environment includes Pega Field Marketing, ensure that all Field Marketing campaigns are in Pending-Details or Resolved-Completed status.
    Caution: If any Field Marketing campaigns are in Open-Running status during the upgrade, they may fail.
  9. If you are upgrading from Pega Marketing 7.13, in the PR4_RULE table located in the PegaRULES database schema, update the length of the pyDescription column to 1000.
  10. If the ServiceLevelEvents agent in the Pega-ProCom ruleset is enabled, disable it.
  11. If you are upgrading from Pega Marketing 7.13, 7.21, or 7.22, import the bundle PegaMarketing_Upgrade_DB_0801.zip.
    The PegaMarketing_Upgrade_DB_0801.zip file is distributed as attachment to the required upgrade hotfix for the version you are upgrading from. For more information, see step 3 above.
  12. Unlock all artifacts rulesets that contain any artifacts which you want to continue using after the upgrade.
  13. Before you upgrade Pega Marketing, ensure that you have the following database information available:
    • Such database connection information as:
      • Hostname or IP address
      • Database port
      • Database name
    • JDBC driver JAR file for your database type
    • PegaRULES schema name
    • If using split schema, PegaDATA schema name
    • Ensure that the Pega Marketing external schema meets the following requirements:
      • This is the schema that contains your customer data repository and other marketing assets.
      • This schema must exist in the same database as the PegaDATA and PegaRULES schemas.
      • This schema must have the database privileges to create views and to select from tables in the PegaDATA schema.
    • Ensure that the Pega Marketing external user and password meet the following requirements:
      • This user must already exist.
      • This is the user that Pega Platform uses to connect to the Pega Marketing external schema.
      • This user must have full privileges to the Pega Marketing external schema.
      • This user must have the database privileges to create views and to select from tables in the PegaDATA schema.
    • Ensure that the Pega Deployment user and password meet the following requirements:
      • This user must already exist.
      • This user must have permissions to create and modify objects in all Pega schemas.
      • If using Oracle, this user must have permission to create materialized views.
    • Ensure that the user associated with PegaDATA DB rule meets the following requirements:
      • This user must be set in application server configuration.
        • For Tomcat, this would typically be in the context.xml file.
      • The user that is mapped to the PegaDATA DB rule must already exist.
      • This user must have the following privileges on the PegaDATA schema:
        • Select, Create, and Drop on tables, indexes, and views
        • Insert, Update, and Delete on tables
        • Alter on tables and indexes
    • Ensure that the user associated with PegaRULES DB rule meets the following requirements:
      • This user must be set in application server configuration.
        • For Tomcat, this would typically be in the context.xml file.
      • The user that is mapped to the PegaRULES DB rule must already exist.
      • This user must have the following privileges on the PegaRULES schema:
        • Select, Create, and Drop on tables, indexes, and views
        • Insert, Update, and Delete on tables
        • Alter on tables and indexes
      • This user can be the same as the PegaDATA user, provided the user has permissions to both schemas.
  14. For IBM Db2 databases, if you use JDBC URL to connect to your external database, add the following parameters to the template URL and the prweb.xml file where the Pega DB connections are defined:
    • resultSetHoldability=1;
    • resultSetHoldabilityForCatalogQueries=1;
    • allowNextOnExhaustedResultSet=1;
    See below for an example of the syntax. The database in the example is set to MYDB and the marketing external schema is set to MKTDATA.
    jdbc:db2://localhost:50000/MYDB:fullyMaterializeLobData=true;
    fullyMaterializeInputStreams=true;
    progressiveStreaming=2;
    progressiveLocators=2;useJDBC4ColumnNameAndLabelSemantics=false;
    currentSchema=MKTDATA;
    resultSetHoldability=1;resultSetHoldabilityForCatalogQueries=1;allowNextOnExhaustedResultSet=1;
    Note:

    The setting values also apply to the PegaDATA and PegaRULES connections created by Pega Platform.

  15. Request the required hotfixes. The list of required hotfixes can be found here: Required Pega Customer Decision Hub and Pega Marketing hotfixes and here Required Pega 1:1 Operations Manager hotfixes.
  16. Check in all checked out rules and log off all users.
  17. Back up existing database and app-server level application data. For more information, see Backing up your system.
  18. Log in as an operator with the your application:MKTAdmins access group.
  19. Edit the your application:MKTAdmins access group, or another access group with administrator privileges which your application uses, and add the PegaRULES:SecurityAdministrator user role.
    Note: The PegaRULES:SecurityAdministrator role is required to manage operator access in Pega Customer Decision Hub. At least one administrator access group in your application must include this role.
  20. Finalize any in-use database templates.
  21. If you are using Paid Media Manager:
    1. Ensure that your Cassandra database version is 3.11.3 or newer.
      This is required for the Paid Media landing page to work correctly.
    2. In the navigation pane of App Studio, click SettingsChannelsPaid mediaSync tracking, and verify that all sync jobs are complete.
    3. In the navigation pane of the Pega Customer Decision Hub, click Next-Best-ActionDesignerChannels.
    4. In the Channels section, click Edit.
    5. Disable Paid, and then click Save.
  22. Click ConfigureDecisioningDecisionsData flowsBatch Processing and ensure there are no data flow runs in progress.
  23. Disable agent schedules by performing the following actions:
    1. Click RecordsSysAdminAgent Schedule.
    2. Open all Pega Marketing agent schedules, including the following:
      • PegaMKT-Engine
      • PegaMKT-PushNotification
      • PegaMKT-Install
      • PegaMKT-FieldMarketing (if installed)
    3. Uncheck Enable this agent and ensure that each individual agent is disabled.
    4. Click Save.
    Note: If you do not disable agent schedules, the agents will automatically restart after Pega Marketing has been upgraded to Pega Customer Decision Hub, with existing scheduled queue items trying to run, unsuccessfully. This will result in a list of broken queue items that you will need to address manually.
  24. Update to the latest version of Pega Platform 8.6, and ensure that you can log in as an administrator. For more information, see the Pega Platform Update Guide for your environment on the Deploy Pega Platform page.
    Note: If you are installing on a UTF-8 encoded database, see Issue: "Error: Commit failed" when loading CPM 6.1 RuleSets into a UTF-8 encoded database.
  25. In Admin Studio, stop the RevalidateAndSave agent from the Pega-ImportExport ruleset on all nodes.
  26. Disable the agent schedule for the RevalidateAndSave agent.
  • Previous topic Pega Customer Decision Hub or Pega Marketing 7.x to Pega Customer Decision Hub 8.6 Upgrade Guide
  • Next topic Pre-Upgrade Check for Pega Customer Decision Hub

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