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 Automation Agent with rpm Packages

On this page

Overview

The Automation Agent runs on every host that runs a monitored MongoDB deployment. The agent provides the interface for starting and managing deployments. If you run MongoDB on hardware that you provision, you must install the Automation Agent manually on each server. If you run MongoDB through the Ops Manager integration with Amazon Web Services (AWS), Ops Manager automatically deploys the Automation Agents every time you provision an new EC2 instance.

Automation Agents can run only on 64-bit architectures.

Use this procedure to install the agent on RHEL, CentOS, SUSE, Amazon Linux, and other systems that use rpm packages.

Prerequisites

Before installing the agent, review the Automation Checklist for considerations and prerequisites specific to the agent.

Procedures

This section includes procedures for both installing and updating the Automation Agent.

Install the Automation Agent with an rpm Package

1

Download the latest version of the Automation Agent archive.

On a system shell, issue a command that resembles the following. Replace amd64 with your platform, as needed:

copy 
curl -OL <OpsManagerCentralURL>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm
2

Install the Automation Agent Package

copy 
sudo rpm -U mongodb-mms-automation-agent-manager-latest.x86_64.rpm
3

Edit the automation-agent.config file.

Edit the automation-agent.config file.

copy 
sudo vi /etc/mongodb-mms/automation-agent.config

For mmsGroupId, enter your GroupID as the value. For mmsApiKey, enter your API key.

copy 
mmsGroupId=<Group ID>
mmsApiKey=<API Key>

For SUSE 11+ deployments only, configure the sslTrustedMMSServerCertificate setting. All other users should omit this step.

copy 
sslTrustedMMSServerCertificate=/etc/ssl/certs/UTN_USERFirst_Hardware_Root_CA.pem
4

Prepare a directory in which to store your MongoDB data.

The directory must be owned by the mongod user. For example, use a set of commands similar to the following:

copy 
sudo mkdir /data
sudo chown mongod:mongod /data
5

Start the Automation Agent.

Issue the following command:

copy 
sudo service mongodb-mms-automation-agent start

Update the Automation Agent with an rpm Package

You do not need to stop the agent to install. The update package automatically stops, unpacks, and then restarts the agent.

1

Download the latest version of the Automation Agent archive.

On a system shell, issue a command that resembles the following. Replace amd64 with your platform, as needed:

copy 
curl -OL <OpsManagerCentralURL>/download/agent/automation/mongodb-mms-automation-agent-manager-latest.x86_64.rpm
2

Install the Automation Agent Package

copy 
sudo rpm -U mongodb-mms-automation-agent-manager-latest.x86_64.rpm
3

Prepare a directory in which to store your MongoDB data.

The directory must be owned by the mongod user. For example, use a set of commands similar to the following:

copy 
sudo mkdir /data
sudo chown mongod:mongod /data

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