Make a logical backup

Before you start

1. Install and set up Percona Backup for MongoDB
2. Check that pbm agent is running with the pbm status command

3. Check that all pbm-agents and PBM CLI have the same version. Otherwise we cannot guarantee successful backups and data consistency in them.

   To check the version, run the following commands:

   • pbm status to check the version of pbm-agents
   • pbm version to check the version of PBM CLI.

Procedure

Warning

Sharded time series collections are not supported. If you use them in your deployment, you won’t be able to make a backup.

To make a backup, run the following command:

$ pbm backup --type=logical

Logical backup is the default one so you can bypass the --type flag.

During logical backups, Percona Backup for MongoDB copies the actual data to the backup storage.

Starting with version 2.0.0, Percona Backup for MongoDB stores data in the new multi-file format where each collection has a separate file. The oplog is stored for all namespaces regardless whether this is a full or selective backup.

Multi-format is now the default data format since it allows selective restore. Note, however, that you can make only full restores from backups made with earlier versions of Percona Backup for MongoDB.

Next steps

List backups Make a restore

Useful links

• Backup and restore types
• Schedule backups

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert

---

Last update: November 1, 2024
Created: November 1, 2024