Atom Server and SOAP Server rule forms are deprecated
Valid from Pega Version 7.2
The Atom Server and SOAP Server rule forms are deprecated. Use the Connect CMIS rule form instead.
Existing rules that were created with the deprecated forms still work, but you cannot create new ones.
Updated default dynamic system setting for requestor pools
Valid from Pega Version 8.4
Clients can now enable or disable requestor pools for processing service requests using a new dynamic system setting called EnableRequestorPools with Pega-IntegrationEngine as the owning rulest. Previously, all deployments utilized requestor pools to improve service processing response efficiency; requestor pools eliminated overhead by automatically returning a requestor to the pool after it fulfills a service request. Starting in Pega Platform 8.4, requestor pools are disabled in Client-managed cloud deployments, since these deployments use autoscaling to handle service request traffic. Enabling requestor pools in Kubernetes environments is not recommended, because they can inhibit the default autoscaling settings in the environment.
Requestor pools remain enabled by default in Pega Cloud and on-premises environments.
To help clients navigate this change, Pega has updated its best practice guidance for configuring requestor pools. For an overview, see Requestor pooling for services. For guidance on the use of requestor pools in your application, see the EnableRequestorPools entry in Dynamic system settings data instances.
Upgrade impact
Requestor pools are disabled by default in Pega Platform 8.4 in client-managed cloud deployments. Clients who deployed previous versions of Pega Platform on a Kubernetes environment and who upgrade to Pega Platform 8.4 could see that their services behave differently.
What steps are required to update the application to be compatible with this change?
If clients that are deployed in a Client-managed cloud environment need to configure their services to use requestor pools and they understand how to configure requestor pools for their optimized use, these clients can re-enable requestor pools. Clients should review the best practice for configuring requestor pools before they re-enable requestor pools. To re-enable requestor pools, you modify the EnableRequestorPools setting in the Pega-IntegrationEngine Owning ruleset from “disabled” to Enabled [no value]. For details, see Editing a dynamic system setting.
Email Wizard support discontinued
Valid from Pega Version 8.4
Pega Platform™ no longer includes the Email Wizard. This wizard helped set up an email service for sending and receiving email in Pega Platform. The wizard generated an email account, an email listener, and an email service rule.
After an upgrade to Pega Platform 8.4 and later, existing clients must create new email accounts and email channels in App Studio. When you configure a new email channel, you add your email accounts so that customers can send and receive email by using the Pega Email Bot. Configuration of an email channel automatically generates an email listener and service email rules.
For more information, see Creating an email account and Building an Email channel.
Deprecation of EAR deployments in Pega Platform 8.6
Valid from Pega Version 8.6
Starting with Pega Platform 8.6, EAR deployments of Pega Platform are deprecated. In the upcoming 8.7 release, EAR deployments will not be supported. The following rules that require EAR deployments will also be deprecated and no longer supported in Pega Platform 8.7:
- Connect EJB
- Connect JCA
- JCA Resource Adapter
- JMS MDB Listener
- Service EJB
With this deprecation, you can use the latest tools and keep your application up to date.
Upgrade impact
In Pega Platform 8.6, you can still create rules that require EAR deployments and update existing rules. However, after an upgrade to Pega Platform 8.7, rules that require EAR deployments are no longer supported.
What steps are required to update an application to be compatible with this change?
To prepare your application for this change well in advance of the Pega Platform 8.7 release, see the following table for a list of alternative rules and for guidance on modernizing your application.
| Deprecated rule type | Alternative rule type | Recommended configuration |
| Connect EJB | Connect REST | Substitute legacy EJB resources with a REST API, and use REST connectors to interact with them. |
| Connect JCA | Connect REST | Substitute legacy JCA resources with a REST API, and use REST connectors to interact with them. |
| JCA Resource Adapter | JCA resource adapters are data records that are used within the scope of a Connect JCA rule. If you replaced Connect JCA rules in your application with Connect REST rules, JCA resource adapters are no longer relevant. | No further configuration is necessary. |
| JMS MDB Listener | JMS Listener | Replace JMS MDB Listener configurations with standard JMS Listener configurations. |
| Service EJB | Service REST | Redefine your EJB services as a set of RESTful service APIs, and invoke them over HTTP/HTTPS. |
For information on the supported platforms that are affected by this deprecation, see Pega Platform 8.6 Support Guide.
Legacy Parse XML rule configurations must be upgraded to edit them
Valid from Pega Version 8.6
If your application has Parse XML rules that use the legacy configuration from Pega Platform™ 5.x, you cannot edit these rules after you upgrade to Pega Platform 8.6 until after you upgrade them to use tree-based parse rule configuration.
You must upgrade a Parse XML rule that you want to edit if it shows the following warning when you open it in Dev Studio.
This type of Parse XML rule is deprecated. An upgrade should be performed.
An option to upgrade also displays below the message.
Upgrade impact
Parse XML rules with the legacy configuration do not map data to the clipboard, and the rule definition is empty. After you upgrade to Pega Platform 8.6, you cannot edit Parse XML rules that you created in Pega Platform 5.x or earlier until you upgrade them to use tree-based parse rule configuration.
What steps are required to update an application to be compatible with this change?
Update legacy Parse XML rules to use tree-based parse rule configuration before you edit them in Pega Platform 8.6. Using tree-based parse rules is considered a best practice.
- Open the legacy Parse XML rule.
- On the Mapping tab, click Upgrade.
Result: The Allow tree editing? check box is displayed and is automatically selected. You can add attributes and elements to the tree structure, or delete them. - Save the upgraded rule configuration.
For more information, see Parse XML rules.
Connect MQ rules configured with alias queue do not work after upgrade
Valid from Pega Version 8.6
Connect MQ rules that you defined with an alias queue in earlier versions of Pega Platform do not work after an upgrade to Pega Platform 8.6.
Upgrade impact
If you defined an alias queue in Connect MQ rules, after an upgrade to Pega Platform 8.6, those Connect MQ rules do not work.
What steps are required to update an application to be compatible with this change?
In the Pega-IntegrationEngine ruleset, create the following dynamic system settings and their default values:
- "mq/pmo" = 0
- "mq/gmo" = 0
- "mq/oo_request" = 1040
- "mq/oo_response" = 16
For more information, see Creating a dynamic system setting.