Skip to main content


Quiescing high availability nodes

Suggest edit Updated on August 18, 2021

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.

Did you find this content helpful? YesNo

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

Close Deprecation Notice
Contact us