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 .

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.

Procedure

  1. Stop the mongod service

    $ sudo systemctl stop mongod
    
  2. Install percona-release . If you have installed it before, upgrade it to the latest version

  3. Enable the repository. Choose your preferable method:

    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-60-pro]
      USER_NAME=<Your Customer ID>
      REPO_TOKEN=<Your PRO repository token>
      
    2. Enable the repository

      $ sudo percona-release enable psmdb-60-pro release
      
  4. Install Percona Server for MongoDB Pro packages

    $ sudo apt install -y percona-server-mongodb-pro
    
  5. Start the server

    $ sudo systemctl start mongod
    
  1. Stop the mongod service

    $ sudo systemctl stop mongod
    
  2. Install percona-release . If you have installed it before, upgrade it to the latest version.

  3. Enable the repository. Choose your preferable method:

    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
      
  4. Install Percona Server for MongoDB Pro packages

    $ 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
      
  5. 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 7.0.4 and higher is done automatically by installing the basic build packages.

If you wish to downgrade from Percona Server for MongoDB Pro to the basic build of Percona Server for MongoDB version lower than 7.0.4, 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.