Configure Maintenance Window
On this page
You can set the hour of the day that Atlas should start weekly maintenance on your cluster. This setting is optional and is not required for most clusters. Configure maintenance windows from your project settings.
Typically, you do not need to manually configure a maintenance window. Atlas performs maintenance automatically in a rolling manner to preserve continuous availability, with the exception of a momentary replica set election. You can use the Test Failover capability to ensure that your application is resilient to replica set elections.
Custom maintenance windows provide greater control over your cluster performance by allowing maintenance to occur at your preferred time of day.
Maintenance Window Considerations
Urgent Maintenance Activities
Atlas performs urgent maintenance activities such as security patches as soon as they are needed without regard to scheduled maintenance windows.
Note
Some non-urgent updates that don't require a
mongod restart, for example backend services updates, might also
occur without regard to scheduled maintenance windows.
Ongoing Maintenance Operations
Once you schedule a maintenance window for your cluster, you cannot change it until any ongoing maintenance operations have completed.
MongoDB Database Upgrades
If maintenance include the upgrade of the MongoDB versions, Atlas displays the current and target versions in the console.
Maintenance Requires Replica Set Elections
Atlas performs maintenance the same way as the maintenance procedure described in the MongoDB Manual. This procedure requires at least one replica set election during the maintenance window per replica set.
Use the Test Failover capability to ensure that your application is resilient to replica set elections.
Maintenance Starts As Close to the Hour As Possible
Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time.
Procedure
Open Your Project Settings
Navigate to the Settings page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
Next to the Projects menu, expand the Options menu, then click Project Settings.
View or modify project settings.
View and Configure Maintenance Window
Clear Your Maintenance Window Configuration Settings
If you configured a preferred maintenance window start time, you can clear the settings using the Atlas CLI or the Atlas UI. Clearing your maintenance window configuration restores the default maintenance window settings.
Respond to Required Maintenance
When maintenance is required, Atlas:
Displays a banner in your project's cluster list showing the date and time when the maintenance is scheduled.
Sends a notification email to users with the
Project Ownerrole between 48 and 72 hours before the scheduled maintenance.Note
To configure how you receive scheduled maintenance window notifications, see Configure a Maintenance Window Alert.
Maintenance Version Upgrades during Maintenance Windows
If Atlas will upgrade the MongoDB maintenance version on one of your clusters during the next maintenance window, the cluster's card displays the target MongoDB maintenance version.
