Installing Percona Server for MongoDB on Red Hat Enterprise Linux and CentOS¶
Use this document to install Percona Server for MongoDB on RPM-based distributions from Percona repositories.
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. [1]
Package Contents¶
Package | Contains |
percona-server-mongodb | The mongo 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 mongo 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 |
Installing from Percona repositories¶
The preferable way to install Percona Server for MongoDB is from Percona repositories. Percona repositories are managed using the percona-release tool.
Configure Percona repository¶
Run the following commands as root or by using the sudo command
Install percona-release:
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
Example of Output
Retrieving https://repo.percona.com/yum/percona-release-latest.noarch.rpm Preparing... ########################################### [100%] 1:percona-release ########################################### [100%]
Enable the repository:
percona-release enable psmdb-44 release
See also
- More information about how to use the
percona-release
tool - https://www.percona.com/doc/percona-repo-config/index.html
Install the latest version¶
To install the latest version of Percona Server for MongoDB, use the following command:
$ sudo yum install percona-server-mongodb
Install a specific version¶
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 4.4.0-1.el8 psmdb-44-release-x86_64
Install a specific version packages. For example, to install Percona Server for MongoDB 4.4.0-1, run the following command:
$ sudo yum install percona-server-mongodb-4.4.0-1.el8
Running Percona Server for MongoDB¶
Warning
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
SELINUX
in/etc/selinux/config
todisabled
. This change takes effect after you reboot.Run SELinux in permissive mode by setting
SELINUX
in/etc/selinux/config
topermissive
. This change takes effect after you reboot.You can also enforce permissive mode at runtime using the
setenforce 0
command. 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 /etc/mongod.conf
.
- 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:
systemctl status mongod
$ sudo systemctl status mongod
- Stopping the service
Stop the service using the following command:
systemctl stop mongod
$ sudo systemctl stop mongod
- Restarting the service
Restart the service using the following command:
systemctl restart mongod
$ sudo systemctl restart mongod
Running after reboot¶
The mongod
service is not automatically started
after you reboot the system.
For RHEL or CentOS versions 5 and 6, you can use the chkconfig
utility
to enable auto-start as follows:
$ sudo chkconfig --add mongod
For RHEL or CentOS version 7, you can use the systemctl
utility:
$ sudo systemctl enable mongod
Uninstalling Percona Server for MongoDB¶
To completely uninstall Percona Server for MongoDB you’ll need to remove all the installed packages and data files:
Run the following commands as root or by using the sudo command
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:
$ sudo rm -rf /var/lib/mongodb $ sudo rm -f /etc/mongod.conf
Warning
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.
Footnotes
[1] | 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.rpm packages can be used
to rebuild Percona Server for any environment.
Please contact our support service
if you require further information on this. |
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 professional services, contact Percona Sales.