Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Crash recovery

Updated on April 5, 2022

The Pega Platform provides crash recovery for browser and servers. With crash recovery enabled, the Pega Platform saves the structure of the user interface and relevant work metadata to the database on user interface events.

The following matrix details the events that occur if a browser, Pega Platform server, or machine crashes.

EventsBrowser crash Pega Platform server crash
Pega Platform application user interface is redrawn YesYes
User must re-authenticate
  • No, if redirected to the same Pega Platform server
  • Yes, if authentication cookie was lost
  • No, with SSO
  • Yes, without SSO
Data entry loss
  • No, if redirected to the same Pega Platform server
  • Data not committed is lost if authentication cookie was lost
Data not committed is lost

Additionally, after a crash event, users must:

  • Reacquire work object locks.
  • Manually reopen assignments.
  • Server crash recovery

    Pega Platform server failover occurs when you have enabled periodic work recording to shared storage and the Pega Platform server that fails is taken out of service from the load balancer.

  • Browser crash recovery

    Browser crash recovery is provided as a part of the Pega Platform. The state of a Pega Platform application is recovered without loss. The clipboard preserves both metadata for the user interface and any data entered on screens and submitted.

  • Enabling crash notification

    You can configure Pega Platform to display a message to users in the event of a server or browser crash. When a user is notified of a crash, the default message says "Your session was disrupted. Please verify all work in progress." You can customize this message.

  • Enabling periodic work recording

    To recover from server or browser crashes, you can configure Pega Platform to periodically record work in progress. When configured in this way, the system saves metadata about the state of user interface interactions, tabs, and screens, and restores the UI state to the last persisted state after a crash.

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