Navigation
This version of the documentation is archived and no longer supported. It will be removed on EOL_DATE. 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.
This version of the manual is no longer supported. It will be removed on EOL_DATE.

Install or Update the Monitoring Agent from an Archive

Important

This page describes how to install the agent manually. The easier way to install and run the Monitoring Agent is through Automation, as described in Install or Update the Monitoring Agent through Automation.

The Ops Manager Monitoring Agent is a lightweight component that runs within your infrastructure, connects to your MongoDB processes, collects data about the state of your deployment, and then sends the data to Ops Manager, which processes and renders this data. The agent initiates all connections between the agent and Ops Manager, and communications between the agent and Ops Manager are encrypted.

A single agent can collect data for your entire deployment. You can run multiple agents to distribute assignments and to provide agent failover.

This tutorial guides you through the steps necessary to install or update the Monitoring Agent on your system. You must install the Ops Manager itself before installing the Monitoring Agent.

See Monitoring FAQs for additional information.

Considerations

Connectivity

You must configure the network infrastructure of your deployment so that:

  • the Monitoring Agent can connect to all mongod and mongos instances that you want to monitor.
  • the Monitoring Agent can connect to Ops Manager on port 8080 if it is using HTTP or 8443 if it is using HTTPS.

Ops Manager does not make any outbound connections to the agents or to MongoDB instances. If Exposed DB Host Check is enabled, Ops Manager will attempt to connect to your servers occasionally as part of a vulnerability check.

Ensure all mongod and mongos instances are not accessible to hosts outside your deployment.

Multiple Monitoring Agents

You can run multiple Monitoring Agents to distribute monitoring assignments and provide failover. Ops Manager distributes monitoring assignments among up to 100 running agents. Each agent monitors a different set of MongoDB processes. One Monitoring Agent per project is the primary agent. The primary agent reports the cluster’s status to Ops Manager. As agents are added or shut down, Ops Manager redistributes assignments. If the primary agent fails, Ops Manager assigns another agent to be the primary agent.

Important

To distribute monitoring assignments among multiple Monitoring Agents, you must use Monitoring Agent version 5.0.0 or higher.

If you run more than 100 Monitoring Agents, the additional agents run as standby agents. A standby agent is completely idle, except to log its status as a standby and periodically ask Ops Manager if it should begin monitoring.

For versions of the Monitoring Agent earlier than version 5.0.0, only one agent handles monitoring assignments. All other running agents are standby agents.

To tune the frequency at which standby agents check to see if they should begin monitoring and the interval Ops Manager uses to determine if a standby agent should start monitoring, see Monitoring Agent Session Failover.

If you install multiple Monitoring Agents, ensure that all the Monitoring Agents can reach all the mongod processes in the deployment.

To install multiple agents, simply repeat the installation process.

Collection Interval

If a Monitoring Agent is abruptly stopped, without using an appropriate stop command, Ops Manager will wait 5 minutes before redistributing that agent’s monitoring assignments, which means there can be up to a five-minute delay before another Monitoring Agent begins collecting data and sending pings to Ops Manager. During this interval, the restarted Monitoring Agent will not collect data.

File Descriptors

If you install the Monitoring Agent from a tar.gz archive, you my need to increase the number of open file descriptors allowed for the user running the agent. You can use the ulimit command. See Ulimits in the MongoDB manual.

Prerequisites

Access Control

If your MongoDB deployment enforces access control, you must create a user in MongoDB with the appropriate access. See Configure Monitoring Agent for Access Control.

Acquire an Agent API Key

Ops Manager Agents require one Agent API Key per project to communicate with the Ops Manager Application.

If you do not have an existing Agent API Key for your Ops Manager project, you need to create one:

  1. Navigate to Agents, then Agent API Keys

  2. Click plus icon Generate.

    Note

    The button appears only if the current user is the project owner and the project either has no Agent API keys or just the Original Group API key. An Original Group API key exists only in projects created prior to the new Agent API Key model. The new model allows a project to have more than one key and permits any of the project’s agents to use any of the keys. For more information, see Manage Agent API Keys. If you do not see the + Generate Key button and do not remember your existing agent api key, you can generate a key on the Agent API Keys tab. To navigate to the tab, select Deployment view, then click the Agents tab and then the Agent API Keys tab.

  3. Enter your password and click Verify.

  4. Click plus icon Generate again.

    Important

    When you generate an Agent API key, Ops Manager displays it one time only. You must copy it and store it in a secure place. Ops Manager will never display the full key again.

Install the Monitoring Agent from an Archive

For RHEL / CentOS (7.x) and SUSE 12 on x64 architecture:

1

Log in to the Ops Manager Application.

2
3

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

4

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

5

Change into the extracted binary directory.

Change into the directory that was created after extracting the Monitoring Agent binary:

cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64
cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64
6

Edit the monitoring-agent.config file.

In the directory where you installed the Monitoring Agent, open the monitoring-agent.config file in your preferred text editor.

Update the following configuration keys:

Key Change
mmsGroupId Set to your ProjectID.
mmsApiKey Set to the project’s agent API key.
7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

For RHEL / CentOS (7.x) on PowerPC architecture (managing MongoDB 3.4 or later deployments only):

1

Log in to the Ops Manager Application.

2

Navigate to Agent Downloads.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
3

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

4

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

5

Change into the extracted binary directory.

Change into the directory that was created after extracting the Monitoring Agent binary:

cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64
cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64
6

Edit the monitoring-agent.config file.

In the directory where you installed the Monitoring Agent, open the monitoring-agent.config file in your preferred text editor.

Update the following configuration keys:

Key Change
mmsGroupId Set to your ProjectID.
mmsApiKey Set to the project’s agent API key.
7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

For Ubuntu (16.04) on PowerPC architecture (managing MongoDB 3.4 or later deployments only):

1

Log in to the Ops Manager Application.

2

Navigate to Agent Downloads.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
3

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

4

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

5

Change into the extracted binary directory.

Change into the directory that was created after extracting the Monitoring Agent binary:

cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64
cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64
6

Edit the monitoring-agent.config file.

In the directory where you installed the Monitoring Agent, open the monitoring-agent.config file in your preferred text editor.

Update the following configuration keys:

Key Change
mmsGroupId Set to your ProjectID.
mmsApiKey Set to the project’s agent API key.
7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

For all other Linux distributions:

1

Log in to the Ops Manager Application.

2

Navigate to Agent Downloads.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
3

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

4

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

5

Change into the extracted binary directory.

Change into the directory that was created after extracting the Monitoring Agent binary:

cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64
cd mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le
cd mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64
6

Edit the monitoring-agent.config file.

In the directory where you installed the Monitoring Agent, open the monitoring-agent.config file in your preferred text editor.

Update the following configuration keys:

Key Change
mmsGroupId Set to your ProjectID.
mmsApiKey Set to the project’s agent API key.
7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

Update the Monitoring Agent from an Archive

You can also access update instructions in Ops Manager, including commands you can copy and paste: click Deployment, then Agents, then Downloads & Settings.

For RHEL / CentOS (7.x) and SUSE 12 on x64 architecture:

1

Log in the the host where the Monitoring Agent is installed.

2

Stop any currently running Monitoring Agents.

Issue the following command:

pkill -f mongodb-mms-monitoring-agent
3

Log in to the Ops Manager Application.

4

Select the Linux distribution for your Agent host.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
5

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

6

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

For RHEL / CentOS (7.x) on PowerPC architecture (managing MongoDB 3.4 or later deployments only):

1

Log in the the host where the Monitoring Agent is installed.

2

Stop any currently running Monitoring Agents.

Issue the following command:

pkill -f mongodb-mms-monitoring-agent
3

Log in to the Ops Manager Application.

4

Select the Linux distribution for your Agent host.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
5

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

6

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

For Ubuntu (16.04) on PowerPC architecture (managing MongoDB 3.4 or later deployments only):

1

Log in the the host where the Monitoring Agent is installed.

2

Stop any currently running Monitoring Agents.

Issue the following command:

pkill -f mongodb-mms-monitoring-agent
3

Log in to the Ops Manager Application.

4

Select the Linux distribution for your Agent host.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
5

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

6

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &

For all other Linux distributions:

1

Log in the the host where the Monitoring Agent is installed.

2

Stop any currently running Monitoring Agents.

Issue the following command:

pkill -f mongodb-mms-monitoring-agent
3

Log in to the Ops Manager Application.

4

Select the Linux distribution for your Agent host.

  1. Click Deployment.
  2. Click Agents.
  3. Click Downloads & Settings.
  1. Click RHEL/CentOS 7.X, SUSE12 - TAR.
  1. Click RHEL/CentOS 7.X Power (ppc64le) - TAR.
  1. Click Ubuntu 16.X Power (ppc64le) - TAR.
  1. Click Other Linux - TAR.
5

Download the latest version of the Monitoring Agent archive.

From a system shell on the host that will run the Monitoring Agent, issue a curl command to download the archive for your platform:

curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
curl -OL https://<OpsManagerHost>:<Port>/download/agent/monitoring/mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

Note

Replace <OpsManagerHost>:<Port> with the hostname and port of your Ops Manager Application.

6

Extract the Monitoring Agent.

You can install the Monitoring Agent in any directory. You can move the archive to another directory before extracting.

tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_x86_64.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.rhel7_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.ubuntu1604_ppc64le.tar.gz
tar -xvzf mongodb-mms-monitoring-agent-7.2.0.488-1.linux_x86_64.tar.gz

When the command completes, the Monitoring Agent is installed.

7

Optional: Configure the Monitoring Agent to use a proxy server.

To configure the agent to connect to Ops Manager via a proxy server, you must specify the server in the httpProxy environment variable. In the <install-directory>/monitoring-agent.config file, set the httpProxy value to the URL of to your proxy server:

httpProxy="http://proxy.example.com:9000"
8

Start the Monitoring Agent.

Issue the following command:

nohup ./mongodb-mms-monitoring-agent >> monitoring-agent.log 2>&1 &