Install from Percona repositories¶

To install the software from Percona repositories means to subscribe to them. Percona provides the percona-release repository management tool. It automatically enables the required repository so that you can install and update both Percona Backup for MongoDB packages and required dependencies smoothly.

What nodes to install on¶

`pbm-agent`¶

Install pbm-agent on all servers that have mongod nodes in the MongoDB cluster (or non-sharded replica set). You don’t need to start it on the arbiter node, since it doesn’t have the data set.

`pbm` CLI¶

You can install pbm CLI on any or all servers or desktop computers you wish to use it from. Those computers must not be network-blocked from accessing the MongoDB cluster.

Before you start¶

Check the system requirements and supported MongoDB versions.

Procedure¶

Warning: Run the following commands as root or via the sudo command.

Configure Percona repository¶

Percona provides the percona-release configuration tool that simplifies operating repositories and enables to install and update both Percona Backup for MongoDB packages and required dependencies smoothly.

Install percona-release .

Enable the repository

$ sudo percona-release enable pbm release

Install Percona Backup for MongoDB packages¶

On Debian and Ubuntu On RHEL and derivatives On Amazon Linux 2023

Reload the local package database:
```
$ sudo apt update
```

Install Percona Backup for MongoDB:

$ sudo apt install percona-backup-mongodb

Run the following command to install the packages:

$ sudo yum install percona-backup-mongodb

Run the following command to install the packages:

$ sudo yum install percona-backup-mongodb

After the installation completes, you have the following tools:

Tool	Purpose
`pbm`	Command-line interface for controlling the backup system
`pbm-agent`	An agent for running backup/restore actions on a database host
`pbm-speed-test`	An interface for field-testing compression and backup upload speed
`pbm-agent-entrypoint`	An entry point application that allows starting `pbm-agent` and also restarts it in case of any faults

Next steps¶

Initial setup

Last update: May 23, 2025
Created: May 23, 2025