Install Percona Server for MongoDB on Red Hat Enterprise Linux and derivatives¶

This document describes how to install Percona Server for MongoDB on RPM-based distributions such as Red Hat Enterprise Linux and compatible derivatives. We gather Telemetry data to understand the use of the software and improve our products.

Note

Percona Server for MongoDB should work on other RPM-based distributions (for example, Amazon Linux AMI and Oracle Linux), 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¶

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.

Install percona-release:

$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm

Example output

Retrieving https://repo.percona.com/yum/percona-release-latest.noarch.rpm
Preparing...                ########################################### [100%]
1:percona-release        ########################################### [100%]

Enable the repository:

$ sudo percona-release enable psmdb-80 release

Install Percona Server for MongoDB packages¶

Install the latest version Install a specific version

To install the latest version of Percona Server for MongoDB, use the following command:

$ sudo yum install percona-server-mongodb

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

List available versions:

$ sudo yum list percona-server-mongodb --showduplicates

Sample output:

    Available Packages

percona-server-mongodb.x86_64    8.0.4-1.el9       psmdb-80-release-x86_64

Install a specific version packages. For example, to install Percona Server for MongoDB 8.0.4-1, run the following command:
```
$ sudo yum install percona-server-mongodb-8.0.4-1.el9
```

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

Enable Transparent Hugepages (THP)¶

Enable Transparent Hugepages (THP) before starting Percona Server for MongoDB 8.0. THP is required to use the new TCMalloc version with MongoDB. For how to enable THP, see Enable Transparent Hugepages (THP) section of documentation.

Run Percona Server for MongoDB¶

Note

If you use SELinux in enforcing mode, you must customize your SELinux user policies to allow access to certain /sys and /proc files for OS-level statistics. Also, you must customize directory and port access policies if you are using non-default locations.

Please refer to Configure SELinux section of MongoDB Documentation for policy configuration guidelines.

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

Start the service

Percona Server for MongoDB is not started automatically after installation. Start it manually using the following command:

$ sudo systemctl start mongod

Confirm that service is running

Check the service status using the following command: service mongod status

$ sudo systemctl status mongod

Stop the service

Stop the service using the following command: service mongod stop

$ sudo systemctl stop mongod

Restart the service

Restart the service using the following command: service mongod restart

$ sudo systemctl restart mongod

Run after reboot¶

The mongod service is not automatically started after you reboot the system.

To make it start automatically after reboot, enable it using the systemctl utility:

$ sudo systemctl enable mongod

Then start the mongod service:

$ sudo systemctl start mongod

Next steps¶

Connect to MongoDB

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 Join Percona Squad