This documentation is for the end of life version of Percona Server for MongoDB and is no longer supported. You may want to see the current documentation.
Installing Percona Server for MongoDB on Red Hat Enterprise Linux and CentOS¶
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. 1.
mongoshell, import/export tools, other client utilities, server software, default configuration, and init.d scripts.
mongodserver, default configuration files, and init.d scripts.
mongossharded cluster query router.
Contains Mongo tools for high-performance MongoDB fork from Percona.
Contains debug symbols for the server.
It is recommended to install Percona Server for MongoDB from official Percona repositories
Configure Percona repositories as described in Percona Software Repositories Documentation.
Starting from Percona Server for MongoDB 3.6.19-7.0, the packages are located in the
psmdb-36 repository. To install the latest version of Percona Server for MongoDB, do the following:
Enable the repository.
$ sudo percona-release enable psmdb-36
Install the required Percona Server for MongoDB package using yum. For example, to install the full package, run the following:
$ sudo yum install Percona-Server-MongoDB-36
Earlier versions of Percona Server for MongoDB are located in the
original repository. To install a specific version:
Enable the original repository:
$ sudo percona-release enable original
List available packages:
$ sudo yum list Percona-Server-MongoDB-36 --showduplicates
Available Packages Percona-Server-MongoDB-36.x86_64 3.6.17-4.0.el8 percona-release-x86_64 Percona-Server-MongoDB-36.x86_64 3.6.18-5.0.el8 percona-release-x86_64 Percona-Server-MongoDB-36.x86_64 3.6.18-6.0.el8 percona-release-x86_64 Percona-Server-MongoDB-36.x86_64 3.6.19-7.0.el8 percona-release-x86_64
Install a specific version packages. For example, to install Percona Server for MongoDB 3.6.17-4.0, use the following command:
$ sudo yum install Percona-Server-MongoDB-36-3.6.17-4.0.el8
If you have SELinux security module installed, it will conflict with Percona Server for MongoDB. There are several options to deal with this:
Remove the SELinux packages. This is not recommended, because it may violate security.
Disable SELinux by setting
disabled. This change takes effect after you reboot.
Run SELinux in permissive mode by setting
permissive. This change takes effect after you reboot.
You can also enforce permissive mode at runtime using the
setenforce 0command. However, this will not affect the configuration after a reboot.
Percona Server for MongoDB stores data files in
/var/lib/mongodb/ by default.
The configuration file is
Starting the service
Percona Server for MongoDB is not started automatically after installation. Start it manually using the following command:
$ sudo systemctl start mongod
Confirming that 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
mongod service is not automatically started
after you reboot the system.
For RHEL or CentOS versions 5 and 6, you can use the
to enable auto-start as follows:
$ chkconfig --add mongod
For RHEL or CentOS version 7, you can use the
systemctl utility as follows:
$ systemctl enable mongod
To completely uninstall Percona Server for MongoDB you’ll need to remove all the installed packages and data files:
Stop the Percona Server for MongoDB service:
$ sudo systemctl stop mongod
Remove the packages:
$ sudo yum remove Percona-Server-MongoDB*
Remove the data and configuration files:
$ rm -rf /var/lib/mongodb $ rm -f /etc/mongod.cnf
This will remove all the packages and delete all the data files (databases, tables, logs, etc.). You might want to back up your data before doing this in case you need the data later.
We support only the current stable RHEL 6 and CentOS 6 releases, because there is no official (i.e. RedHat provided) method to support or download the latest OpenSSL on RHEL and CentOS versions prior to 6.5. Similarly, and also as a result thereof, there is no official Percona way to support the latest Percona Server builds on RHEL and CentOS versions prior to 6.5. Additionally, many users will need to upgrade to OpenSSL 1.0.1g or later (due to the Heartbleed vulnerability), and this OpenSSL version is not available for download from any official RHEL and CentOS repositories for versions 6.4 and prior. For any officially unsupported system,
src.rpmpackages can be used to rebuild Percona Server for any environment. Please contact our support service if you require further information on this.