Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Performing a rolling upgrade

Updated on April 5, 2022

You can upgrade Pega Platform by performing a rolling upgrade (rolling restart) that keeps your system available during the upgrade process. You remove nodes from the load balancer, shut them down, upgrade, and restart each node one by one. When you have upgraded half of the nodes, you add them back to the load balancer.

  1. Follow these general steps to upgrade your database. For detailed information about each step, see your Upgrade Guide for performing an out-of-place upgrade.
    1. Disable rule saving.
    2. Migrate the PegaRULES schema to a temporary schema.
    3. Update the new rules schema, for example, a framework or application update.
    4. Copy the new rule schema to the production database.
  2. Upgrade half of the nodes one by one. For each node, do the following steps:
    1. Quiesce the node and remove it from the load balancer, following the instructions in Quiescing a node with immediate drain or Quiescing a node with slow drain, depending on your cluster configuration.
    2. Shut down the node.
    3. Configure the node to connect to the updated rules schema. For more information, see your Upgrade Guide for migrating the rules schema.
    4. Restart the node.
    5. Perform any needed post-upgrade activities and tests.
  3. Change the load balanced configuration to point to the upgraded nodes.
  4. Do step 2 for the remaining nodes, and then reactivate them in the load balancer.
  • Previous topic Managing clusters by using Autonomic Event Services (AES)
  • Next topic Quiesce behavior during high availability upgrades

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us