Skip to main content

Table of Contents

Performing a rolling upgrade


Only available versions of this content are shown in the dropdown

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 To quiesce a node using immediate drain or To quiesce 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.

Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us