Install Percona Server for MongoDB Pro

This document provides guidelines how to install Percona Server for MongoDB Pro from Percona repositories and from binary tarballs. Learn more about Percona Server for MongoDB Pro.

If you already run Percona Server for MongoDB and wish to upgrade to Percona Server for MongoDB Pro, see the upgrade guide.

Before you start

Request the access to the pro repository from Percona Support. You will receive the client ID and the access token.

Install from Percona repository

Debian and Ubuntu RHEL and derivatives

1. Configure the repository. Create the /etc/apt/sources.list.d/psmdb-pro.list configuration file with the following contents:

   /etc/apt/sources.list.d/psmdb-pro.list

   deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-70-pro/apt/ OPERATING_SYSTEM main
   

2. Update the local cache

   $ sudo apt update
   

3. Install Percona Server for MongoDB Pro packages

   $ sudo apt install -y percona-server-mongodb-pro
   

4. Start the server

   $ sudo systemctl start mongod
   

1. Configure the repository. Create the /etc/yum.repos.d/psmdb-pro.repo configuration file with the following contents:

   /etc/yum.repos.d/psmdb-pro.repo

   [psmdb-7.0-pro]
   name=PSMDB_7.0_PRO
   baseurl=http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-70-pro/yum/main/$releasever/RPMS/x86_64
   enabled=1
   gpgkey = https://repo.percona.com/yum/PERCONA-PACKAGING-KEY
   

2. Install Percona Server for MongoDB Pro packages

   $ sudo yum install -y percona-server-mongodb-pro
   

3. Start the server

   $ sudo systemctl start mongod
   

Install from binary tarballs

Binary tarballs are available for the following operating systems:

Starting with version 7.0.7-4:

• Ubuntu 22.04 (Jammy Jellyfish)
• Red Hat Enterprise Linux 9
• Debian 12 (bookworm)

Starting with version 7.0.8-5

• Red Hat Enterprise Linux 8

Preconditions

The following packages are required for the installation.

On Debian and Ubuntu On RHEL and derivatives

• libcurl4

• libsasl2-modules

• libsasl2-modules-gssapi-mit

• libcurl

• cyrus-sasl-gssapi

• cyrus-sasl-plain

Procedure

The steps below describe the installation on Ubuntu 22.04.

1. Download the tarballs from the pro repository

   $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-70-pro/tarballs/percona-server-mongodb-pro-7.0.8-5-x86_64.jammy.tar.gz\
   $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-70-pro/tarballs/percona-mongodb-mongosh-2.1.5-x86_64.tar.gz
   

   2. Extract the tarballs

   $ tar -xf percona-server-mongodb-7.0.8-5-x86_64.jammy.tar.gz
   $ tar -xf percona-mongodb-mongosh-2.1.5-x86_64.tar.gz
   

2. Add the location of the binaries to the PATH variable:

   $ export PATH=~/percona-server-mongodb-pro-7.0.8-5-x86_64.jammy/bin/:~/percona-mongodb-mongosh-2.1.5/bin/:$PATH
   

3. Create the default data directory:

   $ mkdir -p /data/db
   

4. Make sure that you have read and write permissions for the data directory and run mongod.

Next steps

Connect to MongoDB

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