Hot Backup¶
Percona Server for MongoDB includes an integrated open-source hot backup system for the default WiredTiger and alternative MongoRocks storage engine. It creates a physical data backup on a running server without notable performance and operating degradation.
To take a hot backup of the database in your current dbpath
,
run the createBackup
command as administrator on the admin
database
and specify the backup directory.
> use admin
switched to db admin
> db.runCommand({createBackup: 1, backupDir: "/my/backup/data/path"})
{ "ok" : 1 }
If the backup was successful, you should receive an { "ok" : 1 }
object.
If there was an error, you will receive a failing ok
status
with the error message, for example:
> db.runCommand({createBackup: 1, backupDir: ""})
{ "ok" : 0, "errmsg" : "Destination path must be absolute" }
Hint
Restoring data from the backup
To restore your backup, you need to stop the mongod
service, clean the data
directory and then copy the files from the backup directory to your data
directory. Finally, start the mongod
service again.
$ # Stopping the mongod service
$ service mongod stop
$ # Clean the data directory (assuming /var/lib/mongodb/)
$ rm -rf /var/lib/mongodb/*
$ # Copy the files from the backup directory to the data directory
$ cp --recursive /my/backup/data/path /var/lib/mongodb/
$ # Starting the mongod service
$ service mongod start
Contact Us
For free technical help, visit the Percona Community Forum.To report bugs or submit feature requests, open a JIRA ticket.
For paid support and managed or professional services, contact Percona Sales.