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 from an Archive

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.

Use this procedure to install the Automation Agent on a Linux system not listed in the Agent Downloads list on the Agents page in the Administration tab.

Automation Agents can run only on 64-bit architectures.

Prerequisites

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

Procedure

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

Install the Automation Agent from an Archive

1

Download the latest version of the Automation Agent archive.

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

curl -OL <OpsManagerCentralURL>/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz
2

Install the Automation Agent.

To install the agent, extract the archive using a command that resembles the following. Replace linux_x86_64 with your platform, as needed:

tar -xf mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz

The Automation Agent is installed.

3

Edit the local.config file to include your Group ID and Ops Manager API key.

In the directory where you installed the Automation Agent, edit the local.config file.

  • For mmsGroupId, enter your GroupID as the value.
  • For mmsApiKey, enter your API key.
mmsGroupId=<Group ID>
mmsApiKey=<API Key>
4

Create Automation Directory

Create the directories /var/lib/mongodb-mms-automation, /var/log/mongodb-mms-automation and /data and ensure that the user running the agent owns the directories.

5

Start the Automation Agent.

Issue the following command:

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

Update the Automation Agent from an Archive

1

Stop any currently running Automation Agents.

Issue the following command:

pkill -f mongodb-mms-automation-agent
2

Download the latest version of the Automation Agent archive.

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

curl -OL <OpsManagerCentralURL>/download/agent/automation/mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz
3

Install the Automation Agent.

To install the agent, extract the archive using a command that resembles the following. Replace linux_x86_64 with your platform, as needed:

tar -xf mongodb-mms-automation-agent-latest.linux_x86_64.tar.gz

The Automation Agent is installed.

4

Edit the local.config file to include your Group ID and Ops Manager API key.

In the directory where you installed the Automation Agent, edit the local.config file.

  • For mmsGroupId, enter your GroupID as the value.
  • For mmsApiKey, enter your API key.
mmsGroupId=<Group ID>
mmsApiKey=<API Key>
5

Create Automation Directory

Create the directories /var/lib/mongodb-mms-automation, /var/log/mongodb-mms-automation and /data and ensure that the user running the agent owns the directories.

6

Start the Automation Agent.

Issue the following command:

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