Skip to content
Percona Software for MongoDB Documentation

For help, click the link below to get free database assistance or contact our experts for personalized support.

Get help from Percona

Percona Backup for MongoDB 2.8.0 (2024-12-12)

Installation

Percona Backup for MongoDB is a distributed, low-impact solution for creating consistent backups of MongoDB sharded clusters and replica sets, and for restoring those backups to a specific point in time.

Release Highlights

This release provides the following features and improvements:

Better organization of selective backups

Now you can define multiple namespaces not only for selective restores but also for selective backups. This way you can better organize your backups as you accumulate the required data under a single backup. See how to make a backup of several namespaces in the tutorial.

Network routing control in communication of pbm-agents with the backup storage

You can now control how pbm-agents reach the same remote backup storage by defining custom endpoints for them. This way you respect the network settings of the data centers where the servers running pbm-agents reside and ensure the proper functioning of PBM. Custom endpoints are supported for AWS and Microsoft Azure Blob storages. Learn more about the endpoint definition in the documentation

Simplified troubleshooting with restoring the same collection under a different name

Now you can restore a single collection under a different name up to a certain point in time alongside the current collection. The restored collection has the same data and indexes as the one you backed up. This makes it easier to compare the data in both collections and identify what caused the issue with the database. As a result, your troubleshooting efforts significantly reduce.

To learn more about this functionality, refer to the Restore a collection under a different name section in the documentation

Reduced troubleshooting time with diagnostics report

Collect all information required to troubleshoot backups and restores in one go. Generate the comprehensive diagnostics report about an operation execution and either dive deep yourself or file a bug report to our experts and attach the diagnostics archive to it. This way you reduce the iteration time and speed up the issue resolution.

Check the Diagnostics report for more details.

Improved log rotation with a custom path for log output

You can now output logging information from every pbm-agent to a file at a custom path. This way you can introduce log rotation, manage the system log effectively and comply to security regulations for logging and auditing.

Learn more about how to configure custom log path in the documentation

Additional flexibility for backups

PBM no longer uses mongodump for making backups but uses its own dump implementation. This makes backup operations flexible as it lifts the mongodumps’ limitations and opens space for further improvements.

Changes in supported MongoDB versions

Starting from this release, PBM supports Percona Server for MongoDB 8.0 and MongoDB Community 8.0.

At the same time, PBM no longer supports Percona Server for MongoDB 5.0 and MongoDB Community 5.0 as it entered the end-of-life stage. Existing functionality remains compatible with version 5.0. However, we will no longer test new features and improvements against this version.

Known limitation

Selective backups and restores fail for setups with config shards. Find more details in PBM-1465.

Changelog

New Features

  • PBM-887 - Add the ability to generate diagnostics report

  • PBM-1211 - Ability to set multiple endpoints to the same S3 storage

  • PBM-1226 - Add the ability to define a custom log path for pbm-agent via environment variables or a command line

  • PBM-1421 - Add the ability to clone a collection

  • PBM-1422 - Adjust Oplog and PITR to support a cloned collection

  • PBM-1454 Configuration file for all pbm-agent’s options

Improvements

  • PBM-1358 - Improve the selective restore behavior for deployments having a Config shard

  • PBM-1405 - Implement dump to replace mongodump for more flexibility

  • PBM-1414- Change the default –numInsertionWorkersPerCollection and add ability to define them via command line

  • PBM-1417 - Allow defining multiple namespaces for selective backup

Bugs Fixed

  • PBM-1347 - Report error in pbm describe-restore output if point-in-time restore fails because of inappropriate time to restore

  • PBM-1366 - Fixed the issue with pbm-agent failing if a collection is dropped during logical backup

  • PBM-1390- Fixed the issue with a possible agent crash by mongodump on backup cancel

  • PBM-1398 - Prevent modifying collections and indexes for excluded namespaces by ensuring all operations from oplog are excluded for them.

  • PBM-1426 - Fix sporadic failures of PBM during physical restore with point-in-time recovery by adding additional check for internal database restart to complete

  • PBM-1441 - Add a License file to Docker image to pass Red Hat’s certification

Last update: April 11, 2025
Created: April 11, 2025