Skip to content

Upgrade to Percona Server for MongoDB Pro

Are you a Percona Customer already and are you ready to enjoy all the benefits of Percona Server for MongoDB Pro?

This document provides instructions how you can upgrade from Percona Server for MongoDB to Percona Server for MongoDB Pro.

Preconditions

Request the access to the Percona Server for MongoDB Pro repository from Percona Support. You will receive the client ID and the access token.

Procedure

  1. Stop the mongod service

    $ sudo systemctl stop mongod

  2. Configure the repository

    1. 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-60-pro/apt/ OPERATING_SYSTEM main

    2. Update the local cache

      $ sudo apt update

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

    /etc/yum.repos.d/psmdb-pro.repo
    [psmdb-6.0-pro]
name=PSMDB_6.0_PRO
baseurl=http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-pro/yum/main/$releasever/RPMS/x86_64
enabled=1
gpgkey = https://repo.percona.com/yum/PERCONA-PACKAGING-KEY

  3. Install Percona Server for MongoDB Pro packages

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

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

    1. Back up the /etc/mongod.conf configuration file

      $ sudo cp /etc/mongod.conf /etc/mongod.conf.bkp

    2. Remove basic packages of Percona Server for MongoDB 

      $ sudo yum remove percona-server-mongodb*

    3. Install Percona Server for MongoDB Pro packages

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

    4. Restore the configuration file from the backup

      $ sudo cp /etc/mongod.conf.bkp /etc/mongod.conf

  4. Start the server

    $ sudo systemct start mongod

Downgrade considerations on RHEL and derivatives

The downgrade to the basic build of Percona Server for MongoDB of version 6.0.12 and higher is done automatically by installing the basic packages.

If you wish to downgrade from Percona Server for MongoDB Pro to the basic build of Percona Server for MongoDB version lower than 6.0.12, do the following:

  1. Remove the Pro packages

    $ sudo yum remove percona-server-mongodb-pro*

  2. Install Percona Server for MongoDB basic packages of the desired version

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