Upgrading from Percona Server for MongoDB 3.4 to 3.6

Important

MongoRocks is deprecated in Percona Server for MongoDB 3.6. If you are using Percona Server for MongoDB 3.4 with MongoRocks, and you wish to upgrade to version 3.6, please read the note at the top of the MongoRocks page before upgrading: https://www.percona.com/doc/percona-server-for-mongodb/3.6/mongorocks.html

To upgrade Percona Server for MongoDB to version 3.6, you must be running version 3.4. Upgrades from earlier versions are not supported.

Before upgrading your production Percona Server for MongoDB deployments, test all your applications in a testing environment to make sure they are compatible with the new version.

The general procedure for performing an in-place upgrade (where your existing data and configuration files are preserved) includes the following steps:

  1. Stop the mongod instance.
  2. Remove old packages.
  3. Install new packages.
  4. Start the mongod instance.

It is recommended to upgrade Percona Server for MongoDB from official Percona repositories using the corresponding package manager for your system. For more information, see Installing Percona Server for MongoDB.

Warning

Perform a full backup of your data and configuration files before upgrading.

Upgrading on Debian or Ubuntu

  1. Stop the mongod instance:

    sudo service mongod stop
    
  2. Remove Percona Server for MongoDB 3.4 packages:

    sudo apt-get remove percona-server-mongodb-34*
    
  3. Install Percona Server for MongoDB 3.6 packages:

    sudo apt-get install percona-server-mongodb-36
    
  4. If you modified the configuration file and wish to use it with the new version, verify that the /etc/mongod.conf file includes the correct options.

  5. Start the mongod instance:

    sudo service mongod start
    

For more information, see Installing Percona Server for MongoDB on Debian and Ubuntu.

Upgrading on RHEL and CentOS

  1. Stop the mongod instance:

    sudo service mongod stop
    
  2. Remove Percona Server for MongoDB 3.4 packages:

    sudo yum remove Percona-Server-MongoDB-34*
    
  3. Install Percona Server for MongoDB 3.6 packages:

    sudo yum install Percona-Server-MongoDB-36
    
  4. Start the mongod instance:

    sudo service mongod start
    

Note

When you remove old packages on Centos / RHEL, your modified configuration file is placed to /etc/mongod.conf.rpmsave. To use your configuration with the new version, do the following before you start the mongod service:

  • Replace the default /etc/mongod.conf file,

  • Check the permissions for the mongod user to custom paths for database and/or log files.

  • Restore the permissions, if needed:

    chown -R mongod:mongod <dpPathDir> <logDir>
    

For more information, see Installing Percona Server for MongoDB on Red Hat Enterprise Linux and CentOS.