Skip to main content


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

Completing pre-update tasks

Updated on September 3, 2021

Before you update your application, complete the pre-update tasks included in this section.

Pega CRM for Financial Services Update Guide Pega CRM for Financial Services Update Guide Pega CRM for Financial Services Update Guide Pega CRM for Financial Services Update Guide

Completing the prerequisite tasks

Attention: Before starting the update, review this section carefully! You must complete all required prerequisites to prepare your environment for the update.

This document describes how to update the Pega Customer Service for Financial Services and Pega Sales Automation for Financial Services applications. Pega CRM for Financial Services (CRM) provides a single installer for both applications, but each application is licensed separately.

This document applies only to Pega customers who are running the applications on the premises or in a third-party cloud installation. For information about feature adoption steps for Pega Cloud Services environments, see the CRM for Financial Services 8.6 Feature Adoption for Pega Cloud guide on Pega Community.

When completing the prerequisites, back up your system after key milestones to ensure that you can revert to the last working version of the system if you encounter an issue. For instructions, see Backing up your system.

  1. Verify that you have already run the required Pega Customer Service Upgrade Checker and the optional the Sales Automation Upgrade Checker. The upgrade checkers identify rule conflicts between the current version and the new version of the application.
  2. When updating from a version that is not the previous version, review the update guides and release notes for each of the interim versions. For example, if updating from release 8.4 to release 8.6, review the 8.5 update guide, 8.5 release notes, and this guide.
    Some product changes, such as deprecated and withdrawn features, require user action before the update. See Pega Community for legacy update guides and release notes. To review a list of the product changes that have update impacts, see Crucial update information for Pega Customer Relationship Management.
  3. If updating from Pega Customer Service for Financial Services 8.5, apply Hotfix HFIX-80355 before starting the update.
  4. 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.
  5. Determine which language packs are applicable to your product and check for availability.
    For information, see Pega Marketplace.
  6. Update the listed applications in the following order:
    Note: The Pega Foundation for Financial Services installation guide refers to Product Designer for Financial Services (PDFS) as optional, however, Pega Customer Service for Financial Services requires PDFS to be updated.
    1. Pega Foundation for Financial Services 8.6 as described in the Pega Foundation for Financial ServicesUpdateGuide on the Pega Foundation for Financial Services product page.
    2. Pega Product Designer for Financial Services 8.6 as described in the Product Designer for Financial ServicesUpdateGuide on the Pega Foundation for Financial Services product page.
  7. Apply hotfixes that are required to support Pega Foundation for Financial Services and Pega Product Designer for Financial Services before continuing with the update.
  8. Update to Pega Customer Service 8.6 and Pega Sales Automation 8.6. There is a single procedure to update both of those applications.
    Follow all of the instructions, including prerequisites, in the update guide on the Pega Customer Service product page or the Pega Sales Automation product page.
  9. Optional: Because SQL database triggers are no longer supported, before you update the application, have your database administrator check for and drop triggers.
  10. If you are upgrading from a 7.4 version or earlier, take a backup of the CPMFS_NOTES database table using the query create table temp as select * from desired_table. For some database systems, such as DB2, you must also reorganize the columns in the table to match the current version.
  11. Run SQL DROP TABLE CPMFS_NOTES to make the DDL changes.
  12. Optional: Update Pega Call to the latest version. For more information, see the Pega Call Update Guide on the Pega Call product page.

Backing up your system

When updating an application, back up your system after each step to ensure that you can revert to the last working version of the system if you encounter an issue.

Note: The deployment process modifies both the data schema and the rules schema. Use a backup procedure that preserves both schemas.
  1. Verify that all rules are checked in.
  2. Shut down the Pega Platform application server.
  3. Use your database utilities to complete an offline backup of the Pega database.
  4. Back up the configuration and environment files.
    If you edited any of the following Pega Platform configuration files in the APP-INF\classes directory of an EAR deployment or the WEB-INF\classes directory of a WAR deployment, include these files in the backup:
    • prbootstrap.properties
    • prconfig.xml
    • logging file: prlogging.xml or prlog4j2.xml
    • web.xml
    • pegarules.keyring or any other .keyring files
  5. Back up any third-party or custom JAR files that you installed.
    Redeploying the Pega Platform applications might delete these files from your application server.

Updating legacy Pega Customer Service portals

Important! Legacy portals do not work in version 7.21 and later of Pega Customer Service! If updating from version 7.1.4 or earlier of Pega Customer Service for Financial Services, you must update your access groups to use supported portals as part of the update.

The following table shows which portals are supported for each application version.

Portal name/rule name6.2, 6.3, 7.1, 7.1.27.1.3, 7.1.47.21 and higher
CA CSR Portal (CACSRPortal)Not supportedNot supportedNot supported
CA Manager Portal (CAManagerPortal)Not supportedNot supportedNot supported
CA Sales Rep Portal (CASalesRepPortal)Not supportedNot supportedNot supported
CA Sales Manager Portal (CASalesManagerPortal)Not supportedNot supportedNot supported
CPMCSR Portal (CPMCSR_Portal)SupportedDeprecatedNot supported
CPMManager Portal (CPMManager_Portal)SupportedDeprecatedNot supported
CPM Sales Manager Portal (CPMSalesManager_Portal)SupportedDeprecatedNot supported
CPM Sales Rep portal (CPMSalesRep_Portal)SupportedDeprecatedNot supported
Interaction Portal (CPMInteractionPortal)N/ASupportedSupported
Account Manager Portal (CPMAccountManager_Portal)N/ASupportedSupported

(Deprecated in 7.22)

Back Office Portal (BackOfficePortal)N/AN/ASupported

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