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 `mongosh` 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 `mongosh` 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.

Fetch percona-release packages from Percona web:

$ wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb

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.

Enable the repository:

$ sudo percona-release enable psmdb-60 release

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:

List available versions:

$ sudo apt-cache madison percona-server-mongodb

Sample output:

percona-server-mongodb | 6.0.2-1.buster | http://repo.percona.com/psmdb-60/apt buster/main amd64 Packages

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

$ sudo apt install percona-server-mongodb=6.0.2-1.buster percona-server-mongodb-mongos=6.0.2-1.buster percona-server-mongodb-shell=6.0.2-1.buster percona-server-mongodb-server=6.0.2-1.buster percona-server-mongodb-tools=6.0.2-1.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

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.

Community Forum Get a Percona Expert

Last update: July 24, 2023
Created: December 7, 2022