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" }

$ # 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