Skip to content
Percona Software for MongoDB Documentation

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.

  1. Install percona-release .

  2. Enable the repository 

    $ sudo percona-release enable pbm release

Create the /etc/apt/sources.list.d/percona-pbm-release.list configuration file with the following contents:

/etc/apt/sources.list.d/percona-pbm-release.list
deb http://repo.percona.com/pbm/apt OPERATING_SYSTEM main

Create the /etc/yum.repos.d/percona-pbm-release.repo configuration file with the following contents:

/etc/yum.repos.d/percona-pbm-release.repo
[pbm-release-aarch64]
name = Percona Backup MongoDB release/aarch64 YUM repository
baseurl = http://repo.percona.com/pbm/yum/release/$releasever/RPMS/aarch64
enabled = 1
gpgcheck = 1
gpgkey = file:///etc/pki/rpm-gpg/PERCONA-PACKAGING-KEY

Install Percona Backup for MongoDB packages

  1. Reload the local package database: 

    $ sudo apt update

  2. Install Percona Backup for MongoDB: 

    $ sudo apt install percona-backup-mongodb

$ 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

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 Join Percona Squad

Last update: November 13, 2024
Created: November 13, 2024