Update from all legacy Agents
You have a project with automated MongoDB deployments with Monitoring, Backup, or both and want to update to the MongoDB Agent.
Note
Review the Prerequisites First
If you want to start or continue using Automation to manage your MongoDB deployments, please review the MongoDB Agent Prerequisites before updating to the MongoDB Agent.
Procedure
Optional: Unmanage Any Unique Indexes.
If you upgrade from Ops Manager 4.0 to 4.2 or later, edit each deployment to remove any unique indexes from management.
Ops Manager 4.2 and later differs from 4.0 in how it manages index. To view, create, or delete indexes after this upgrade, use Data Explorer.
Warning
Don't drop your unique indexes. You need only remove them from management.
Optional: Add any existing configuration options for your legacy Agents that Automation did not manage.
If Automation did not manage your Backup or Monitoring Agents, you can add any Backup or Monitoring settings you had before at the Add Custom Configuration Options for your MongoDB Agent (Optional) step.
Important
Deployments using Kerberos Authentication
Don't add either of the following settings from the legacy Agents:
krb5Principalkrb5Keytab
Your legacy Agents authenticated with Kerberos as separate database users. Because the MongoDB Agent combines the functions of the legacy Agents, it employs a single database user. To upgrade to the MongoDB Agent and continue using Kerberos, you must:
Create a new Kerberos User Principal and database user for the MongoDB Agent.
Update the Agent authentication configuration in the Ops Manager Authentication & TLS settings with the new MongoDB Agent Principal and Keytab files.
You can remove the legacy Monitoring and Backup Agent users after updating to the MongoDB Agent.
To add options that you had for your Backup Agent and Monitoring Agent:
Under the Backup Configurations section:
Type the desired setting in the Setting box and its corresponding value in the Value box.
To add more than one Setting, click the + Add Setting link. Another row appears.
Repeat until all settings have been added.
Under the Monitoring Configurations section:
Type the desired setting in the Setting box and the corresponding value in the Value box.
To add more than one Setting, click the + Add Setting link. Another row appears.
Repeat until all settings have been added.
Once you have added all the settings necessary for your deployment, click Next.
You can click the to remove any settings that you have added.
Important
Ops Manager does not validate any of these settings. Make sure that the settings and values are correct.
Update automated hosts to MongoDB Agent.
If your project has hosts that use Automation, you can update the Agents on those hosts to the MongoDB Agent.
Click Update All.
Wait until all hosts show Updated.
Click Next.
Important
All authentication SCRAM, LDAP, and Kerberos credentials from
legacy Agents are retained after the update. All .pem key
files are retained as well.
All credentials for the legacy Agents are migrated to the MongoDB Agent.
The legacy Automation Agent credentials become the MongoDB Agent credentials used for Automation. These credentials should not need modification. However, if you need to modify them, navigate to Deployment Security Settings Edit Settings.
The legacy Monitoring Agent credentials can be modified from Deployment Processes Monitoring Settings Credentials.
The legacy Backup Agent credentials can be modified from Continuous Backup Overview <Deployment to Backup> under Options column Edit Credentials.
Next Steps
After the MongoDB Agent update completes: