Install Percona Server for MongoDB on Debian and Ubuntu

This document describes how to install Percona Server for MongoDB from Percona repositories on DEB-based distributions such as 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 mongodserver, default configuration files, andinit.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

Procedure

Configure Percona repository

Percona provides the percona-release configuration tool that simplifies operating repositories and enables to install and update both Percona Backup for MongoDB packages and required dependencies smoothly.

1. Fetch percona-release 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:

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

   After you install this package, you have the access to Percona repositories. You can check the repository setup in the /etc/apt/sources.list.d/percona-release.list file.

3. Enable the repository:

   $ sudo percona-release enable psmdb-42 release
   

4. Remember to update the local cache:

   $ sudo apt update
   

Install Percona Server for MongoDB

Install the latest versionInstall a specific version

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

$ sudo apt install percona-server-mongodb

To install a specific version of Percona Server for MongoDB, do the following:

1. List available versions:

   $ sudo apt-cache madison percona-server-mongodb
   

   Sample output:

   percona-server-mongodb | 4.2.9-9.buster | http://repo.percona.com/psmdb-42/apt buster/main amd64 Packages
   percona-server-mongodb | 4.2.8-8.buster | http://repo.percona.com/psmdb-42/apt buster/main amd64 Packages
   percona-server-mongodb | 4.2.7-7.buster | http://repo.percona.com/psmdb-42/apt buster/main amd64 Packages
   percona-server-mongodb | 4.2.6-6.buster | http://repo.percona.com/psmdb-42/apt buster/main amd64 Packages
   percona-server-mongodb | 4.2.5-5.buster | http://repo.percona.com/psmdb-42/apt buster/main amd64 Packagess
   

2. Install a specific version packages. You must specify each package with the version number. For example, to install Percona Server for MongoDB 4.2.5-5, run the following command:

   $ sudo apt install percona-server-mongodb=4.2.5-5.buster percona-server-mongodb-mongos=4.2.5-5.buster percona-server-mongodb-shell=4.2.5-5.buster percona-server-mongodb-server=4.2.5-5.buster percona-server-mongodb-tools=4.2.5-5.buster
   

Run Percona Server for MongoDB

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

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:

$ sudo systemctl start mongod

Confirming that the service is running

Check the service status using the following command:

$ sudo systemctl status mongod

Stopping the service

Stop the service using the following command:

$ sudo systemctl stop mongod

Restarting the service

Restart the service using the following command:

$ sudo systemctl restart mongod

Contact Us

For free technical help, visit the Percona Community Forum.

To report bugs or submit feature requests, open a JIRA ticket.

For paid support and managed or consulting services , contact Percona Sales.

---

Last update: January 31, 2023
Created: December 8, 2022