Navigation

Restore Overview

To restore a deployment from a backup, select a snapshot or point in time from which you want to restore your database. Cloud Manager provides you with the files from which you can restore your database.

You can restore a single MongoDB database, a replica set, or a sharded cluster. You may select to restore from:

  • An existing snapshot,
  • A specific point in time by selecting:
    • A specific date and time,
    • A specific oplog timestamp, or
    • A specific sharded cluster checkpoint.

If you are restoring from a point in time, you must download the MongoDB Backup Restore Utility to your target host. The MBRU requests and applies oplog entries between the latest complete snapshot and the point in time you chose.

Note

For sharded clusters, enable checkpoints before restoring to a point between snapshots.

You can restore your backup in one of two ways:

Automated Restore

If you choose to have Cloud Manager automation restore your backup, the Automation Agent removes all existing data from the target hosts and replaces that data with new backup data from your snapshot.

Prerequisites

To perform automated restores, you must have:

Restore to Different Project

You can choose to restore to a cluster of a different project:

  • To restore to another Cloud Manager project, you must have Automation Admin or Backup Admin roles for the target project.
  • To restore to another MongoDB Atlas project, you must have Project Owner role for the target project.

Potential Causes for Automated Restore Failure

An automated restore can fail when certain storage settings of the backup’s database and target database do not match:

No method exists to check for mismatches before attempting a restore. If a restore attempt fails, Cloud Manager displays any mismatched settings. If you still want to restore the backup’s database, fix the settings in the target database that do not match backup’s database, then retry the restoring the backup’s database.

Restore Procedures

To perform an automated restore, see the procedure for the deployment you want to restore:

Manual Restore

Prerequisites

To perform manual restores, you must have the Backup Admin role in Cloud Manager.

Considerations

Restore File Format

Cloud Manager provides each snapshot as an uncompressed (.tar) archive containing a complete copy of the data directory.

File Delivery Methods

With a manual restore, Cloud Manager can deliver the snapshots in two ways:

  • Provide a link to download the snapshots through HTTP.

  • Transfer the snapshots to a target directory on a target host that you choose using SCP.

    Note

    If you use SCP, you may choose to transfer the individual database files instead of the snapshot as an archive file.

    Important

    You need to generate a key pair before using SCP. SCP transfers files faster than HTTP.

    Note

    Microsoft Windows does not include SCP. Installing SCP is outside the scope of this manual.

Manual Restore Procedures

To perform a manual restore, see the procedure for the deployment you want to restore: