Skip to main content

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

Quiescing nodes using slow drain

Updated on May 19, 2021

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.

  • The default time-out for passivation is reduced, referred to as an accelerated passivation period.
  • Users are placed in a passivation queue.
  • The system stops non-essential agent processing for quiesce and all listeners, with the exception of message-driven bean (MDB) listeners.
    Note: System critical agents remain active during this step.
  • When the active user requestor count drops to 0, the system sets the server state to "Quiesce Complete" and the Pega Platform server is ready for maintenance.

For a diagram that illustrates the on-premises quiesce flow for highly available systems when using slow drain, see On-premises slow drain quiesce flow

To quiesce a node with slow drain

The slow drain method requires removing the nodes from the load balancer before starting the quiesce process.

To quiesce a node with slow drain, do the following steps:
  1. Identify the Pega Platform node or nodes that you want to quiesce.
  2. Configure the load balancer to disable the identified nodes. See your load balancer documentation for specific configuration instructions. Currently active users and services can complete their work, but no new connections can be made.
  3. Do either of the following:
    • In Admin Studio, click SystemSystem & nodes.
    • In Dev Studio, click ConfigureSystemHigh AvailabilityHA Cluster Management.
  4. Select the check box in front of the node or nodes that you want to quiesce.
  5. Click Quiesce. When the quiesce process is complete, the status of the node changes to Quiesce Complete in the Runstate or State column on the landing page.
    Note: To cancel the quiesce process for the selected node or nodes, click Cancel Quiesce.

On-premises slow drain quiesce flow

The following diagram illustrates the on-premises quiesce flow for highly available systems when using slow drain.

Slow drain quiesce flow
Quiescing a high availability node using slow drain

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