Installing Percona Backup for MongoDB

Percona provides and supports installation packages for Percona Backup for MongoDB in the deb and rpm formats that you can install by using apt or yum or other interfaces to your package management system.

The Percona Software and Platform Lifecycle page lists Linux distributions for which Percona Backup for MongoDB installation packages are available.

The recommended approach is to install Percona Backup for MongoDB from Percona repositories using the percona-release tool.

If you want a full control over the installation, you may build and install Percona Backup for MongoDB from source code.

Regardless of the installation method you choose, the following tools are at your disposal after the installation completes:

Tool Purpose
pbm Command-line interface for controlling the backup system
pbm-agent An agent for running backup/restore actions on a database host

Install pbm-agent on every server that has mongod nodes in the MongoDB cluster (or non-sharded replica set). You can install pbm CLI on any or all servers or desktop computers you wish to use it from, so long as those computers aren’t network-blocked from accessing the MongoDB cluster.

Installing from Percona repositories

To install Percona Backup for MongoDB, first install percona-release tool using the package manager of your operating system. This is a repository management tool that automatically configures the required repository for you.

Follow the instructions in Percona Software repositories documentation to install percona-release.

Enable the repository. As of version 1.3.0, Percona Backup for MongoDB packages are stored in the pbm repository.

$ sudo percona-release enable pbm release

Installing Percona Backup for MongoDB Using apt

$ sudo apt-get update
$ sudo apt-get install percona-backup-mongodb

Installing Percona Backup for MongoDB Using yum

$ sudo yum install percona-backup-mongodb

Building from source code

Building the project requires:

  • Go 1.11 or above
  • make
  • git

See also

Installing and setting up Go tools
https://golang.org/doc/install

To build the project (from the project dir):

$ go get -d github.com/percona/percona-backup-mongodb
$ cd "$(go env GOPATH)/src/github.com/percona/percona-backup-mongodb"
$ make build

After make completes, you can find pbm and pbm-agent binaries in the ./bin directory:

$ cd bin
$ pbm version

By running pbm version, you can verify if Percona Backup for MongoDB has been built correctly and is ready for use.

Output

Version:   [pbm version number]
Platform:  linux/amd64
GitCommit: [commit hash]
GitBranch: master
BuildTime: [time when this version was produced in UTC format]
GoVersion: [Go version number]

After Percona Backup for MongoDB is successfully installed on your system, you have pbm and pbm-agent programs available. See Initial setup for guidelines how to set up Percona Backup for MongoDB.

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.