Navigation
This version of the documentation is archived and no longer supported. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.

Install the Monitoring Agent on CentOS, RHEL, Fedora, Amazon Linux

On this page

Overview

Installing the MMS monitoring agent on CentOS, Fedora, Red Hat Enterprise Linux (RHEL), and Amazon Linux requires a number of Python packages and extensions, including C extensions.

Prerequisites

Before you install the monitoring agent, these software packages must be available or installed on the target system:

  • Python 2.6+
  • setuptools to install Python packages
  • python-dev to install Python C extensions
  • pymongo to install the Python driver used by the monitoring agent
  • agent.py to install the MongoDB monitoring agent

Procedure

1

Install Python Packages and Extensions

Install python-setuptools, which you will use to install the remaining Python dependencies.

copy 
sudo yum install python-setuptools
2

Install Python C Extensions

While the C extensions are not required for On Prem MMS Monitoring, they significantly improve performance. You must have a C compiler (e.g. gcc) and Python header files installed on your system. Type this command to install Python headers:

copy 
sudo yum install gcc python-dev
3

Install and Upgrade PyMongo

If you have not installed pymongo, type this command to install the latest version:

copy 
sudo easy_install pymongo

To upgrade to the latest version of the driver, type this command:

copy 
sudo easy_install -U pymongo

For more information about PyMongo installation, see the Additional Information section below.

If PyMongo was previously installed without C extensions, install PyMongo C extensions.

If you are installing PyMongo and the Monitoring agent on systems that do not have C compilers, build PyMongo packages with PyMongo C extensions.

4

Install the MongoDB Monitoring Agent

Download the latest MMS monitoring agent from the On-Prem MongoDB Management Service, located on the Settings page and the Monitoring Agent tab.

With Python software requirements installed, install the MongoDB monitoring agent with these commands:

copy 
cd mms-agent
nohup python agent.py > /LOG_DIRECTORY/agent.log 2>&1 &

Replace LOG-DIRECTORY with the path to your MongoDB logs.

Next Steps

Once the agent is running and configured, the next step is to deploy the monitoring agent in production.

Also, consider reading the PyMongo documentation.

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.