- Manage Deployments >
- Move or Add a Monitoring or Backup Agent
Move or Add a Monitoring or Backup Agent¶
On this page
Overview¶
When you deploy MongoDB as a replica set or sharded cluster to a group of servers, Ops Manager selects one server to run the Monitoring Agent. If you enable Ops Manager Backup, Ops Manager also selects a server to run the Backup Agent.
You can move the Monitoring and Backup Agents to different servers in the deployment. You might choose to do this, for example, if you are terminating a server.
You also can add additional instances of each agent as hot standbys for high availability. However, this is not standard practice. A single Monitoring Agent and single Backup Agent are sufficient and strongly recommended. If you run multiple agents, only one Monitoring Agent and one Backup Agent per group or environment are primary. Only the primary agent reports cluster status and performs backups. If you run multiple agents, see Confirm Only One Agent is Actively Monitoring.
Procedures¶
Move a Monitoring or Backup Agent to a Different Server¶
To move an agent to a new server, you install a new instance of the agent on the target server, and then remove the agent from its original server.
Select the Deployment tab and then the Deployment page.¶
Click edit mode, and then select the Server View.¶
The Server View displays each provisioned server that is currently running one or more agents.
On the server to which to move the agent, click the gear icon and select to install that type of agent.¶
On the server from which to remove the agent, click the gear icon and remove the agent.¶
Click Review & Deploy to review the configuration.¶
Ops Manager displays the full configuration for you to review.
Click Confirm & Deploy.¶
To view deployment progress, click View Agent Logs and select an agent at the top of the Agent Logs page. To check for updated entries, refresh the page.
If you diagnose an error and need to correct the deployment configuration, click Edit Configuration and then click Edit Configuration again. Reconfigure the deployment through the deployment arrow button or through the Add button. If you cannot find a solution, shut down the deployment. When you complete your changes, click Review & Deploy and then Confirm & Deploy.
Install Additional Agent as Hot Standby for High Availability¶
In general, using only one Monitoring Agent and one Backup Agent is sufficient and strongly recommended. If you run multiple agents, see Confirm Only One Agent is Actively Monitoring to ensure no conflicts.
Select the Deployment tab and then the Deployment page.¶
Click edit mode, and then select the Server View.¶
The Server View displays each provisioned server that is currently running one or more agents.
On the server to which to add an additional agent, click the gear icon and select the agent to add.¶
Click Review & Deploy to review the configuration.¶
Ops Manager displays the full configuration for you to review.
Click Confirm & Deploy.¶
To view deployment progress, click View Agent Logs and select an agent at the top of the Agent Logs page. To check for updated entries, refresh the page.
If you diagnose an error and need to correct the deployment configuration, click Edit Configuration and then click Edit Configuration again. Reconfigure the deployment through the deployment arrow button or through the Add button. If you cannot find a solution, shut down the deployment. When you complete your changes, click Review & Deploy and then Confirm & Deploy.