- Reference >
- Automation Agent >
- Install the Automation Agent >
- Install the Automation Agent with
deb
Packages
Install the Automation Agent with deb
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 procedures to install the Automation Agent on Ubuntu with deb
packages. For Debian systems, use the
Install the Automation Agent from an Archive procedure.
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 a deb
Package¶
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:
Install the Automation Agent Package.¶
Edit the automation-agent.config
file.¶
Edit the automation-agent.config
file.
For mmsGroupId
, enter your GroupID as the value. For
mmsApiKey
, enter your API key.
Prepare a directory in which to store your MongoDB data.¶
The directory must be owned by the mongodb user. For example, use a set of commands similar to the following:
Start the Automation Agent.¶
Issue the following command:
Update the Automation Agent with a deb
Package¶
You do not need to stop the agent to install. The update package automatically stops, unpacks, and then restarts the agent.
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:
Install the Automation Agent Package.¶
Prepare a directory in which to store your MongoDB data.¶
The directory must be owned by the mongodb user. For example, use a set of commands similar to the following: