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.
We gather Telemetry data to understand the use of the software and improve our products.
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¶
Before you start, check the system requirements.
Configure Percona repository¶
Percona provides the percona-release
configuration tool that simplifies operating repositories and enables to install and update both Percona Server 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¶
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.17-14.jammy | http://repo.percona.com/psmdb-60/apt jammy/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.17-14, run the following command:
$ sudo apt install percona-server-mongodb=6.0.17-14.jammy percona-server-mongodb-mongos=6.0.17-14.jammy percona-server-mongodb-shell=6.0.17-14.jammy percona-server-mongodb-server=6.0.17-14.jammy percona-server-mongodb-tools=6.0.17-14.jammy
By default, Percona Server for MongoDB stores data files in /var/lib/mongodb/
and configuration parameters in /etc/mongod.conf
.
Run Percona Server for MongoDB¶
Percona Server for MongoDB is started automatically after installation unless it encounters errors during the installation process.
Start the service
You can manually start the service using the following command:
$ sudo systemctl start mongod
Confirm that the service is running
Check the service status using the following command:
$ sudo systemctl status mongod
Stop the service
$ sudo systemctl stop mongod
Restart the service
$ sudo systemctl restart mongod
Congratulations! Your Percona Server for MongoDB is up and running.
Next steps¶
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.