Skip to main content

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

Quiescing high availability nodes

Updated on May 11, 2022

Quiesce is a process for cleanly taking a Pega Platform node out of service for maintenance or other activities.

When a node is being quiesced, active users are migrated to an active node when the quiescing node is no longer available.

You can use the Pega API or high availability tools to quiesce a node. For more information about these management tools, see Cluster management.

Note: All Pega Platform nodes on a physical or virtual machine must be quiesced before you can perform maintenance on the machine.

Pega Platform offers two types of quiesce: immediate drain (the default), and slow drain. To switch the quiesce method to slow drain, change the value of the session/ha/quiesce/strategy setting in the prconfig.xml file to "slowDrain" and restart the node.

Quiesce a node by using one of the following procedures, depending on how your cluster is configured:

  • Quiescing nodes with immediate drain

    The default method for a quiescing a node is immediate drain, which does not require removing the nodes from the load balancer before starting the quiesce process.

  • Quiescing nodes with slow drain

    Slow drain for quiesce on a highly available system is not the default. The following actions occur on a Pega Platform server when the quiesce process is enabled.

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