Excerpt: MongoDB Backup/Restore

Owned by Rene Beckert
Last updated: Aug 08, 2024 by Cornelius Wachinger
2 min read

The examples given below make use of so called “ephemeral disk space”.

This means that disk space may become an issue if the database is very big and disk space is limited. The ephemeral disk space is located in /var/lib/kubelet and /var/lib/containers. If you have /var/lib placed on a separate disk, you can check the available space with the following command:

df -h /var/lib

Best practices:

  • Label files so that you can identify the contents of the backup as well as the point in time that the backup reflects. The examples below do this already.

  • Use an alternative backup strategy such as Filesystem Snapshots or Cloud Backups in MongoDB Atlas if the performance impact of mongodump and mongorestore is unacceptable for your use case.

  • To ensure mongodump can take a consistent backup of a replica set, you must either use the --oplog option to capture writes received during backup operations or stop all writes to the replica set for the duration of the backup.

    For sharded cluster replica sets, see Back Up a Sharded Cluster with Database Dumps.

  • Ensure that your backups are usable by restoring them to a test MongoDB deployment.

  • To help reduce the likelihood of inconsistencies in a sharded cluster backup, you must stop the balancer, stop all write operations, and stop any schema transformations for the duration of the backup.

Backup MongoDB

Single node MongoDB

Open a shell to your MongoDB node.

To backup the MongoDB instance, run mongodump with the following command-line options:

mongodump --gzip --archive=/tmp/mongobackup_$(date "+%Y.%m.%d_%H.%M.%S").gz

After the backup has completed, there are several ways to retrieve the compressed backup file from the container. Here is an example for Kubernetes:

kubectl cp cdcm/cdcm-mongodb-0:/tmp/mongobackup_<date>.gz .

The <date> portion needs to be adapted to reflect the actual file.

Multi node MongoDB

Open a shell to your primary MongoDB node.

To backup the MongoDB instance, run mongodump with the following command-line options:

The --oplog option captures incoming write operations during the mongodump operation to ensure that the backups reflect a consistent data state.

After the backup has completed, there are several ways to retrieve the compressed file from the container. Here is an example for Kubernetes:

The <date> portion needs to be adapted to reflect the actual file.

Restore MongoDB

First, upload the backup to the target instance.

Make sure that you are using the correct context!

Once again, this example applies to Kubernetes:

To restore a single node MongoDB instance, run mongorestore with the following options:

Restoring a multi node MongoDB

If you used the --oplog option with mongodump, you need to run mongorestore with the --oplogReplay option:

Please find the complete documentation at Back Up and Restore a Self-Managed Deployment with MongoDB Tools