Upgrading from MongoDB Community Edition to Percona Server for MongoDB

Note

MongoDB creates a user that belongs to two groups, which is a potential security risk. This is fixed in Percona Server for MongoDB: user is included only in the mongod group. To avoid problems with current MongoDB setups, existing user group membership is not changed when you migrate to Percona Server for MongoDB. Instead, a new mongod user is created during installation, and it belongs to the mongod group.

In-place upgrades are those which are done using the existing data in the server. Generally speaking, this is stopping the server, removing the old packages, installing the new server and starting it with the same data files. While they may not be suitable for high-complexity environments, they may be adequate for many scenarios.

Warning

Before starting the upgrade process it’s recommended that you perform a full backup (if you don’t have one already).

The upgrade process depends on the distribution you are using:

Upgrading on Debian or Ubuntu

  1. Stop the mongod process:

    $ service mongod stop
    
  2. Check for installed packages:

    $ dpkg -l | grep mongod
    
    ii  mongodb-org                              3.0.6                         amd64        MongoDB open source document-oriented database system (metapackage)
    ii  mongodb-org-mongos                       3.0.6                         amd64        MongoDB sharded cluster query router
    ii  mongodb-org-server                       3.0.6                         amd64        MongoDB database server
    ii  mongodb-org-shell                        3.0.6                         amd64        MongoDB shell client
    ii  mongodb-org-tools                        3.0.6                         amd64        MongoDB tools
    
  3. Remove installed packages:

    $ apt-get remove mongodb-org mongodb-org-mongos mongodb-org-server \
    mongodb-org-shell mongodb-org-tools
    
  4. Install Percona Server for MongoDB using apt.

Upgrading on Red Hat Enterprise Linux or CentOS

  1. Stop the mongod process:

    $ service mongod stop
    
  2. Check for installed packages:

    $ rpm -qa | grep mongo
    
    mongodb-org-3.0.6-1.el6.x86_64
    mongodb-org-server-3.0.6-1.el6.x86_64
    mongodb-org-shell-3.0.6-1.el6.x86_64
    mongodb-org-mongos-3.0.6-1.el6.x86_64
    mongodb-org-tools-3.0.6-1.el6.x86_64
    
  3. Remove installed packages:

    $ yum remove mongodb-org-3.0.6-1.el6.x86_64 mongodb-org-server-3.0.6-1.el6.x86_64 \
    mongodb-org-shell-3.0.6-1.el6.x86_64 mongodb-org-mongos-3.0.6-1.el6.x86_64 \
    mongodb-org-tools-3.0.6-1.el6.x86_64
    
  4. Install Percona Server for MongoDB using yum.