Installing Percona Server for MongoDB on Debian and Ubuntu

Note

Percona Server for MongoDB should work on other DEB-based distributions, but it is tested only on platforms listed on the Percona Software and Platform Lifecycle page.

Package Contents

Package Contains
percona-server-mongodb The mongo shell, import/export tools, other client utilities, server software, default configuration, and init.d scripts.
percona-server-mongodb-server The mongod server, default configuration files, and init.d scripts
percona-server-mongodb-shell The mongo shell
percona-server-mongodb-mongos The mongos sharded cluster query router
percona-server-mongodb-tools Mongo tools for high-performance MongoDB fork from Percona
percona-server-mongodb-dbg Debug symbols for the server

Installing from Percona Repositories

It is recommended to install Percona Server for MongoDB from official Percona repositories using the percona-release utility:

Run the following commands as root or by using the sudo command

  1. Fetch the repository 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:

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

    Once you install this package the Percona repositories should be added. You can check the repository setup in the /etc/apt/sources.list.d/percona-release.list file.

  3. Enable the repository: percona-release enable psmdb-44 release

  4. Remember to update the local cache: apt-get update

Install the latest version

Run the following command to install the latest version of Percona Server for MongoDB:

$ sudo apt-get install percona-server-mongodb

Install a specific version

  1. List available versions:

    $ sudo apt-cache madison percona-server-mongodb
    

    Sample Output

    percona-server-mongodb | 4.4.0-1.buster | http://repo.percona.com/psmdb-44/apt buster/main amd64 Packages
    
  2. Install a specific version packages. You must specify each package with the version number. For example, to install Percona Server for MongoDB 4.4.0-1, run the following command:

    $ sudo apt-get install percona-server-mongodb=4.4.0-1.buster percona-server-mongodb-mongos=4.4.0-1.buster percona-server-mongodb-shell=4.4.0-1.buster percona-server-mongodb-server=4.4.0-1.buster percona-server-mongodb-tools=4.4.0-1.buster
    

Using Percona Server for MongoDB

By default, Percona Server for MongoDB stores data files in /var/lib/mongodb/ and configuration parameters in /etc/mongod.conf.

Run the following commands as root or by using the sudo command

Starting the service
Percona Server for MongoDB is started automatically after installation unless it encounters errors during the installation process. You can also manually start it using the following command: systemctl start mongod
Confirming that the service is running
Check the service status using the following command: systemctl status mongod
Stopping the service
Stop the service using the following command: systemctl stop mongod
Restarting the service
Restart the service using the following command: systemctl restart mongod

Uninstalling Percona Server for MongoDB

To uninstall Percona Server for MongoDB, remove all the installed packages. Removing packages with apt-get remove will leave the configuration and data files. Removing the packages with apt purge will remove all the packages with configuration files and data. Depending on your needs you can choose which command better suits you.

Run the following commands as root or by using the sudo command

  1. Stop the mongod server: systemctl stop mongod
  2. Remove the packages. There are two options. To keep the configuration and data files, run apt-get remove percona-server-mongodb*. If you want to delete the configuration and data files as well as the packages, use apt purge: apt purge percona-server-mongodb*