Skip to main content

MongoDB® - Backup and restore with the CLI

Stephanie R.
Updated

Learn how to manually back up and restore your Cloud Database for MongoDB®.

Cloud Databases allow you to focus on building and deploying cloud applications while OVHcloud takes care of the database infrastructure and maintenance in operational conditions.

 

Requirements

 

Concept

Cloud Databases perform automatic daily backups of your databases. However, you might need to perform manual backup and restore operations to double-ensure data safety on your end or, for example, to export and import data across database instances.

 

Instructions

Ensure you can connect to your database

Follow the guide MongoDB® - Connect with CLI to ensure you can connect to your database. That step ensures that IP filtering is set up properly and that you have a suitable service URI available.

 

Install the MongoDB® Database Tools

Follow the official MongoDB® documentation to install the MongoDB® Database Tools for your platform. You'll need the mongodump and mongorestore binaries to enact the rest of this procedure.

 

Perform a backup of your data

Back up your database to a file using:

$ sudo mongodump --uri="mongodb+srv://<username>:<password>@mongodb-e49d02ee-o2626ab53.database.cloud.ovh.us/admin?replicaSet=replicaset" --gzip --archive=./path/to/backup.gz --readPreference=secondaryPreferred

The MongoDB® user needs to have sufficient privileges to perform the backup operation. This can be ensured by giving this user the backup role.

This operation might take some time - from a few seconds to a few hours, depending on the amount of data your database holds and your network connection. Once it completes, the file path/to/backup.gz will hold a backup of your data.

 

Restore your data from a previous backup

NOTE: This operation might clobber existing data in your database with the data from the backup you restore. Make sure this is what you actually want!

mongorestore merges data

After the restore operation, any data that was stored in your database which isn't also part of the backup file (e.g., other collections or other keys) will be left untouched: That is to say, mongorestore merges data from your backup file with preexisting data in the database.

Restore your database from a backup using:

$ sudo mongorestore --uri="mongodb+srv://<username>:<password>@mongodb-e49d02ee-o2626ab53.database.cloud.ovh.us/admin?replicaSet=replicaset" --gzip --archive=./path/to/backup.gz

The MongoDB® user needs to have sufficient privileges to perform the restore operation. This can be ensured by giving this user the restore role.

Again, depending on the volume of data and your network connection, this operation might take some time. Once it completes, any data contained in your backup file is present in your database.

 

Go further

For more information and tutorials, please see our other Managed Databases & Analytics or Platform as a Service guides. You can also explore the guides for other OVHcloud products and services.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on this link to get a quote and ask our Professional Services experts for a custom analysis of your project.

OVHcloud Managed Databases and Analytics:

  • Grafana® is a registered trademark of Grafana Labs and is used with the permission of Grafana Labs. OVH SAS and its subsidiaries are not affiliated with or endorsed by Grafana Labs.
  • Kafka® is a registered trademark of The Apache Software Foundation and has been licensed for use by OVHcloud, who has no affiliation with and is not endorsed by The Apache Software Foundation.
  • MongoDB® is a registered trademark of MongoDB, Inc.
  • MySQL® is a registered trademark of Oracle and/or its affiliates.
  • PostgreSQL® is a registered trademark of the PostgreSQL Community Association of Canada.

Related articles