Skip to main content

Table of Contents

Configuring your system for passivation and activation


Only available versions of this content are shown in the dropdown

Passivation and activation help with system performance and high availability. Passivation allows a requestor, service, or clipboard page to be saved into storage and reactivated later, helping to free up JVM memory.


Passivation removes operator data from memory if an operator is not active.

When a page is passivated, other pages for that requestor remain in memory, and requestor processing continues normally until that page is needed (such as for read access or for update) and is reactivated into memory. When an entire thread is inactive, the thread context is passivated (including the associated clipboard pages). If the requestor remains idle, eventually the entire requestor context is passivated.

Pega Platform uses database passivation by default, with filesystem passivation available as an alternate method.

To add a process to occur before passivation (for example, saving all call data and closing all tabs in a customer service application), use the pyPrePassivation activity. In order for this activity to be run as expected, you must implement the activity with the correct applies-to class (@baseclass).

The pyPreQuiescePassivation activity is deprecated.


If the operator continues working after a period of inactivity, the system retrieves their work from storage and puts it back into memory, referred to as activation.

When a requestor is activated, the pages that had previously been passivated remain in storage until they need to be activated. If a page is later re-passivated, it is updated accordingly.

To add a process to occur after activation (for example, reconnecting a user with a dropped call), use the pyPostActivation activity. In order for this activity to be run as expected, you must implement the activity with the correct applies-to class (@baseclass).

The pyPostQuiesceActivation activity is deprecated.
  • Changing the default passivation time-out settings

    Passivation time-out is required for high availability environments and is enabled by default. The length of time that pages, threads, or requestors are idle before they are passivated is defined by default. To change passivation times, add the passivation settings to the dynamic system settings and then enter the preferred values.

  • Defining passivation storage

    Pega Platform provides two passivation storage mechanisms: database and filesystem. The default passivation storage is database, which is most efficient and robust.

  • Reporting on passivated requestors

    To see a list of passivated requestors on the PegaRULES database, open and run the standard list view report System-Requestor-Context.RequestorContextList.ALL.

Related Content

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