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.

Add Monitored Processes to Automation


Ops Manager can automate operations for your monitored MongoDB processes. Adding your processes to Automation lets you reconfigure, stop, and restart MongoDB through the Ops Manager interface.

Adding monitored processes involves two steps. First, install the Automation Agent on each server hosting a monitored MongoDB process. Second, add the processes to Automation through the Ops Manager interface.


Automation Agents can run only on 64-bit architectures.

Automation supports most but not all available MongoDB options. Automation supports the options described in Supported MongoDB Options for Automation.

The user running the Automation Agent must the same as the user running the MongoDB process to be managed.

The servers that host the MongoDB processes must have full networking access to each other through their fully qualified domain names (retrieved on each server by issuing hostname -f). Each server must be able to reach every other server through the FQDN.

Ensure that your network configuration allows each Automation Agent to connect to every MongoDB process listed on the Deployment tab. Ensure that the network and security systems, including all interfaces and firewalls, allow these connections.

Ops Manager must be currently monitoring the MongoDB processes, and the Monitoring Agent must be running. The processes must appear in the Ops Manager Deployment tab.


Install the Automation Agent on Each Server

Install the Automation Agent on each server that hosts a monitored MongoDB process. Ensure that the Automation Agent has adequate permissions to stop and restart the existing Monitoring Agent so that it can update the Monitoring Agent as new versions are released.

On each server, you must download the agent, create the necessary directories, and configure the agent’s local.config file with the Group ID and API key.


In Ops Manager, select the Administration tab and then select Agents.


Under Automation at the bottom of the page, click your operation system and follow the instructions to install and run the agent.

For additional information on installing the agent, see Install the Automation Agent.

Add the Processes to Automation


Select the Deployment tab and then the Deployment page.


Click edit mode, and then click the Add button and select Attach to Existing.


Select the MongoDB processes.

Click the Deployment Item field to display your currently monitored processes. Select the cluster, replica set or standalone to add.


Click Start Import.

Ops Manager displays the progress of the import for each MongoDB process, including any errors. If you need to correct errors, click Stop Import, correct them, and restart this procedure.


Click Confirm Import.


Click Review & Deploy.


Click Confirm & Deploy.

Ops Manager Automation takes over the management of the processes and peforms a rolling restart. To view progress, click View Agent Logs.

If you diagnose an error that causes Automation to fail to complete the deployment, click Edit Configuration to correct the error.