install-mongodb-on-red-hat.txt

.. _install-mdb-community-redhat-centos:

======================================================
Install MongoDB Community Edition on Red Hat or CentOS
======================================================

.. default-domain:: mongodb

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: twocols

.. |arrow| unicode:: U+27A4
.. |edition| replace:: Community
.. |package-name| replace:: ``{+package-name-org+}``
.. |distro-name| replace:: Red Hat
.. |package-manager| replace:: ``yum``
.. |executable-name| replace:: ``mongod``

.. include:: includes/rc-available.rst

Overview
--------

.. _`MongoDB Download Center`: https://www.mongodb.com/try/download/community?tck=docs_server

Use this tutorial to install MongoDB {+version+} |edition| Edition on
Red Hat Enterprise Linux, CentOS Linux, or Oracle Linux
[#oracle-linux]_ using the |package-manager| package manager.

MongoDB Version
~~~~~~~~~~~~~~~

.. include:: /includes/fact-install-past-mongodb.rst

Considerations
--------------

Platform Support
~~~~~~~~~~~~~~~~

.. include:: /includes/fact-platform-support-red-hat.rst

Production Notes
~~~~~~~~~~~~~~~~

.. include:: /includes/fact-see-production-notes.rst

.. _install-community-redhat-pkg:

Install MongoDB Community Edition
---------------------------------

Follow these steps to install MongoDB |edition| Edition using the
|package-manager| package manager.

.. include:: /includes/steps/install-mongodb-on-red-hat.rst

Run MongoDB Community Edition
-----------------------------

ulimit
~~~~~~

.. include:: /includes/fact-installation-ulimit.rst

Directory Paths
~~~~~~~~~~~~~~~

To Use Default Directories
``````````````````````````

By default, MongoDB runs using the |mongod-user| user account and
uses the following default directories:

- |mongod-datadir| (the data directory)

- ``/var/log/mongodb`` (the log directory)

The package manager creates the default directories during
installation. The owner and group name are |mongod-user|.

To Use Non-Default Directories
``````````````````````````````

To use a data directory and/or log directory other than the default
directories:

#. Create the new directory or directories.

#. Edit the configuration file ``/etc/mongod.conf`` and modify the
   following fields accordingly:

   - :setting:`storage.dbPath` to specify a new data directory path (e.g. ``/some/data/directory``)

   - :setting:`systemLog.path` to specify a new log file path (e.g. ``/some/log/directory/mongod.log``)

#. Ensure that the user running MongoDB has access to the directory or
   directories:

   .. code-block:: bash

      sudo chown -R mongod:mongod <directory>

   If you change the user that runs the MongoDB process, you **must**
   give the new user access to these directories.

#. Configure SELinux if enforced.  See :ref:`install-rhel-configure-selinux`.

.. _install-selinux-data-directory:

.. _install-rhel-configure-selinux:

Configure SELinux
~~~~~~~~~~~~~~~~~

.. include:: /includes/fact-selinux-redhat-with-policy.rst

.. |mongod-user| replace:: ``mongod``
.. |mongod-datadir| replace:: ``/var/lib/mongo``

Procedure
~~~~~~~~~

Follow these steps to run MongoDB |edition| Edition on your system.
These instructions assume that you are using the default settings.

**Init System**

.. include:: /includes/fact-systemd-vs-initd.rst

.. tabs::

   .. tab:: systemd (systemctl)
      :tabid: systemd-systemctl

      .. include:: /includes/steps/run-mongodb-on-a-linux-distribution-systemd.rst

   .. tab:: System V Init (service)
      :tabid: systemvinit-service

      .. include:: /includes/steps/run-mongodb-on-a-linux-distribution.rst

Uninstall MongoDB Community Edition
-----------------------------------

.. include:: /includes/fact-uninstall.rst

.. include:: /includes/steps/uninstall-mongodb-on-redhat.rst

Additional Information
----------------------

Localhost Binding by Default
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. include:: /includes/fact-installation-bind-ip-default-in-config.rst

MongoDB Community Edition Packages
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. include:: /includes/list-mongodb-org-packages.rst

.. toctree::
   :hidden:
   :titlesonly:

   Install using .tgz Tarball </tutorial/install-mongodb-on-red-hat-tarball>