Skip to content

percona/percona-backup-mongodb

Repository files navigation

Percona Backup for MongoDB

Go Report Card codecov CLA assistant

PBM logo

Percona Backup for MongoDB (PBM) is a distributed, low-impact solution for achieving consistent backups of MongoDB sharded clusters and replica sets. Percona Backup for MongoDB supports Percona Server for MongoDB and MongoDB Community Edition v5.0 and higher.

For more information about PBM components and how to use it, see Percona Backup for MongoDB documentation

Percona Backup for MongoDB includes the following Features:

  • Backup and restore for both classic non-sharded replica sets and sharded clusters
  • Point-in-Time recovery
  • Simple command-line management utility
  • Replica set and sharded cluster consistency through oplog capture
  • Distributed transaction consistency with MongoDB 4.2+
  • Simple, integrated with MongoDB authentication
  • No need to install a coordination service on a separate server
  • Use of any S3-compatible storage
  • Support of locally-mounted remote filesystem backup servers.

Architecture

Percona Backup for MongoDB consists of the following components:

  • pbm-agent is a process running on every mongod node within the cluster or a replica set that performs backup and restore operations.
  • pbm CLI is a command-line utility that instructs pbm-agents to perform an operation.
  • PBM Control collections are special collections in MongoDB that store the configuration data and backup states
  • Remote backup storage as either s3-compatible or filesystem-type storage

Architecture

Read more about PBM architecture.

Installation

You can install Percona Backup for MongoDB in the following ways:

  • from Percona repository (recommended)
  • build from source code

Find the installation instructions in the official documentation

Alternatively, you can run Percona Backup for MongoDB as a Docker container.

API

This repository contains source code for building binaries. It is not a library and is not intended to be used directly by calling exposed functions, types, etc. Please use the pbm CLI as the publicly available API. For reference, see PBM commands.

Submit Bug Report / Feature Request

If you find a bug in Percona Backup for MongoDB, submit a report to the project's JIRA issue tracker.

As a general rule of thumb, please try to create bug reports that are:

  • Reproducible. Include steps to reproduce the problem.
  • Specific. Include as much detail as possible: which version, what environment, etc.
  • Unique. Do not duplicate existing tickets.
  • Scoped to a Single Bug. One bug per report.

When submitting a bug report or a feature, please attach the following information:

  • The output of the pbm status command

  • The output of the pbm logs command. Use the following filters:

    $ pbm logs -x -s D -t 0

NOTE : When reporting an issue with a certain event or a node, you can use the following filters to receive a more specific data set:

#Logs per node
$ pbm logs -x -s D -t 0 -n replset/host:27017
#Logs per event
$ pbm logs -x -s D -t 0 -e restore/2020-10-06T11:45:14Z

Licensing

Percona is dedicated to keeping open source open. We strive to include permissive licensing for our software and documentation wherever possible. For this project, we are using the Apache License 2.0 license.

How to get involved

We encourage contributions and are always looking for new members who are as dedicated to serving the community as we are.

The Contributing Guide contains the guidelines for contributing.

Join Percona Squad!

Participate in monthly SWAG raffles, get early access to new product features, and invite-only ”ask me anything” sessions with database performance experts. Interested? Fill in the form at squad.percona.com/mongodb

                    %                        _____
                   %%%                      |  __ \
                 ###%%%%%%%%%%%%*           | |__) |__ _ __ ___ ___  _ __   __ _
                ###  ##%%      %%%%         |  ___/ _ \ '__/ __/ _ \| '_ \ / _` |
              ####     ##%       %%%%       | |  |  __/ | | (_| (_) | | | | (_| |
             ###        ####      %%%       |_|   \___|_|  \___\___/|_| |_|\__,_|
           ,((###         ###     %%%         _____                       _
          (((( (###        ####  %%%%        / ____|                     | |
         (((     ((#         ######         | (___   __ _ _   _  __ _  __| |
       ((((       (((#        ####           \___ \ / _` | | | |/ _` |/ _` |
      /((          ,(((        *###          ____) | (_| | |_| | (_| | (_| |
    ////             (((         ####       |_____/ \__, |\__,_|\__,_|\__,_|
   ///                ((((        ####                 | |
 /////////////(((((((((((((((((########                |_|  

Contact

You can reach us: