Skip to main content

Managing hibernated environments

Suggest edit Updated on June 9, 2022

You can use Pega Cloud to take action to reduce the energy consumption and carbon footprint of its client environment portfolio by implementing an auto-hibernation process. Pega pauses the cloud resources for your non-production environments, which includes AgileStudio, DevOps, clone and mirror environments, during periods of no-activity use.

You can unpause a hibernated environment by using self-service controls in My Pega Cloud portal. For more information about the auto-hibernation and wake-up process for your Pega Cloud environment, see the Auto-hibernation FAQs.

To use the My Pega Cloud portal, have the following:

  • Cookies enabled in your browser settings.
  • Cloud-admin role or Cloud-change role access privileges. Contact your Pega Cloud administrator to secure those. For more information, see Support user roles.
  • Your My Pega Cloud portal preferences configured. For details, see Configuring your portal preferences.
Note: Pega Cloud performs auto-hibernation on qualifying environments roughly at the end of the business week, and automatically wakes up hibernated environments at the start of the business week. You can perform a self-service wake up on a hibernated environment as required for access at any time.

For more information, see the FAQ question What qualifies my non-Production environment for auto-hibernation and auto-wake up?

Auto-hibernated environments can be unpaused following a wake-up process. When a client navigates to the URL of an auto-hibernated Pega Cloud environment, they can click on a My Pega Cloud link to go to their cloud setup, from where they can wake up their environment. Environments are typically ready within 15 minutes.

Benefits of auto-hibernation

By implementing and tracking auto-hibernation in client environments, Pega can:

  • Reduce its overall carbon footprint
  • Improve understanding about the usage of a client environment
  • Improve the startup and shutdown performance and success

Customizing your auto-hibernation schedule

Clients can request to have their non-production environments automatically hibernate and wake-up. This support includes creating supporting an auto-hibernation cycle schedule that matches your teams' schedule. For example, you can schedule your hibernation cycle to start on 9:00 P.M. PST on Friday, and your wake-up cycle to start on 9:00 A.M. IST on Monday.

To customize your auto-hibernation cycle schedule, create a cloud-change request using My Support Portal. In your request, include the following items:

  • Environment name
  • Day of the week, time, and time zone for hibernation start
  • Day of the week, time, and time zone for wake-up start

Pega requires you to complete a separate cloud-change request for each environment for which you want to schedule an auto-hibernation cycle. For more information on the default hibernation and wake-up schedule, see the FAQ question What qualifies my non-Production environment for auto-hibernation and auto-wake up?

Waking up your hibernated Pega Cloud environment

After a period of no-activity usage, your environment will begin a hibernating phase before entering a hibernated state that pauses usage of system resources. Once hibernated, you wake up your environments through the following method:

  1. Go to the URL of your Pega application that is hosted in your Pega Cloud environment.

    The system replaces the display of your Pega Platform instance with a hibernated environment banner similar to that in the following image:

    Hibernated environment

  2. Click self-service portal to go to My Pega Cloud.
  3. On the Home tab of My Pega Cloud, on the My cloud setup tile, click View details.
  4. In the Environments section, in the row containing your hibernated environment, click the More icon.

    The Environments tab
    Selecting a hibernated environment in the list of environment types.

  5. Select Wake up.
  6. In the resulting Wake Up Environment dialog box, click Wake Up.
    Wake Up button for hibernating environment
    Select Wake Up button
Your environment enters the Waking Up status, and will enter a Running state in approximately 15 minutes.

Environment status changed to Waking Up
The status of a hibernated environment that is waking up changes to Waking Up.

Auto-hibernation FAQs

Consider these Frequently Asked Questions (FAQ) to become familiar with common inquiries about the Pega Cloud auto-hibernation process.

What qualifies my non-production environment for auto-hibernation and auto-wake up?

Pega Cloud automatically hibernates non-production environments, which includes AgileStudio, DevOps, clone and mirror environments, that meet the following criteria:

  1. On a Friday, the time is roughly after when environments typically stop usage for the business week.
  2. Within this time frame, Pega Cloud detects two consecutive hours of no activity on the environment.

After meeting these criteria, Pega Cloud initiates auto-hibernation on the environment.

On the following Monday, Pega Cloud initiates auto-wake up on the environment, beginning roughly at the time environments typically start usage for the business week.

Are Production environments affected by the auto-hibernation process?

No, production environments cannot be auto-hibernated. The system only performs auto-hibernation on qualifying non-production environments.

What are the different statuses of running and hibernated environments in My Pega Cloud?

My Support Portal uses the following statuses on the My cloud setup tab:
Running- The environment is running and available for use.
Hibernating- Pega Cloud has detected a period of no activity in your environment, and the auto-hibernation phase has begun but is not complete. You cannot wake up an environment while it is in Hibernating status.
Hibernated- The environment has paused resource consumption and must be woken up before it can run again.
Waking up - The environment has been woken up from its hibernated state, and will resume running and consuming cloud resources in roughly 15 minutes.
How long does it take to wake up my environment?

Typically, within 15 minutes.

Can I restart a hibernating or hibernated environment?

No, the option to restart a hibernating-status or hibernated-status environment is not available in My Pega Cloud. Once the environment has been woken up, the environment will be available for restart.

What if I can’t wake up my environment?

There may be circumstances where this process takes longer than expected. In such circumstances, the process automatically creates a client-facing INC ticket on your behalf. To see the status of any issues, see the Support requests section in My Pega Cloud. For the latest documentation on making requests, see My Support Portal: New design, streamlined features.

What happens to data in my environment during auto-hibernation?

All of the data in the environment is safe. Data is persisted and fully encrypted prior to suspending cloud resources.

Who can wake up an environment?

Clients must have access to view and use the My Pega Cloud portal. For most clients, this means that they must be connected through their company network prior to accessing their Pega Cloud environment.

For more information about how to gain access to My Pega Cloud, see Configuring your portal preferences.

How does Pega perform maintenance on hibernated environments?

Pega Cloud automatically wakes up hibernated environments prior to performing maintenance.

For more information about scheduled maintenance activities, see Pega Cloud maintenance and types of system updates.

Can I proactively auto-hibernate My Pega Cloud environments?

To learn more about auto-hibernation or proactive auto-hibernation, you can contact Pega and request more information by selecting New request in My Support Portal.

Can I use Deployment Manager while my environment is auto-hibernated?

No, you cannot use Deployment Manager while your environment is auto-hibernated.

Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

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