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

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 7, 2022