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.

Get the access token to the Pro repository

As a Percona Customer, you have the access to the ServiceNow portal. To request the access token, do the following:

1. In ServiceNow, click My Account and select Entitlements.
2. Select your entitlement.

3. If you are entitled for Pro builds, you will see the Token Management widget. Click the Get Percona Builds Token button.

   If you don’t see the widget, contact Percona Support.

4. Click Request Token button in the Request a Percona Pro Builds Token dialog window.

5. A token will be generated for you. You will also see the Customer ID. Copy both the Customer ID and the token as you will use them to configure the Pro repository and install the software.

Install from Percona repository

1. Install percona-release repository management tool.

   Debian and Ubuntu RHEL and derivatives

   1. Fetch percona-release packages from Percona web:

      $ wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb
      

   2. Install the downloaded package with dpkg:

      $ sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb
      

   3. Update the local cache

      $ sudo apt update
      

   Install percona-release using the following command:

   $ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
   

2. Enable the repository. Choose your preferable method:

   Command line Configuration file

   Run the following command and pass your credentials to the Pro repository:

   $ sudo percona-release enable psmdb-70-pro release --user_name=<Your Customer ID> --repo_token=<Your PRO repository token>
   

   1. Create the /root/.percona-private-repos.config configuration file with the following content:

      /root/.percona-private-repos.config

      [psmdb-70-pro]
      USER_NAME=<Your Customer ID>
      REPO_TOKEN=<Your PRO repository token>
      

   2. Enable the repository

      $ sudo percona-release enable psmdb-70-pro release
      

3. Install Percona Server for MongoDB Pro packages:

   Debian and Ubuntu RHEL and derivatives

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

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

4. 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

On Debian and Ubuntu On RHEL and derivatives

The steps below describe the installation on Ubuntu 22.04. Replace the link to the tarball for your desired operating system in the following steps:

1. Download the tarballs from the Pro repository

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

2. Extract the tarballs

   $ tar -xf percona-server-mongodb-7.0.15-9-x86_64.jammy.tar.gz
   $ tar -xf percona-mongodb-mongosh-2.3.2-x86_64.tar.gz
   

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

   $ export PATH=~/percona-server-mongodb-pro-7.0.15-9-x86_64.jammy/bin/:~/percona-mongodb-mongosh-2.3.2/bin/:$PATH
   

4. Create the default data directory:

   $ mkdir -p /data/db
   

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

The steps below describe the installation on Red Hat 9.0. Replace the link to the tarball for your desired operating system in the following steps:

1. Download the tarballs from the Pro repository

   $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-70-pro/tarballs/percona-server-mongodb-7.0.15-9/percona-server-mongodb-pro-7.0.15-9-x86_64.ol9.tar.gz \
   $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-70-pro/tarballs/percona-mongodb-mongosh-2.3.2/percona-mongodb-mongosh-2.3.2-x86_64.tar.gz
   

2. Extract the tarballs

   $ tar -xf percona-server-mongodb-7.0.15-9-x86_64.ol9.tar.gz
   $ tar -xf percona-mongodb-mongosh-2.3.2-x86_64.tar.gz
   

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

   $ export PATH=~/percona-server-mongodb-pro-7.0.15-9-x86_64.ol9/bin/:~/percona-mongodb-mongosh-2.3.2/bin/:$PATH
   

4. Create the default data directory:

   $ mkdir -p /data/db
   

5. 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