Docs Menu
Docs Home
/
MongoDB Cloud Manager
/
MongoDB Agent
/
Update

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

1

Log in to the Cloud Manager.

2

From the notification banner, click Update All Agents.

The Update to MongoDB Agent page opens to start the update process. The Introducing the MongoDB Agent step displays. When you have finished reading this step, click Next.

3

From the notification banner, click Update All Agents.

The Update to MongoDB Agent page opens to start the update process. The Introducing the MongoDB Agent step displays. When you have finished reading this step, click Next.

4

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.

  1. Click Update All.

  2. Wait until all hosts show Updated.

  3. 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:

  1. In MongoDB Cloud Manager, go to the Deployment page for your project.

    1. If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

    2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

    3. If the Deployment page is not already displayed, click Deployment in the sidebar.

      The Deployment page displays.

  2. Go to the Security page.

    1. Click the Security tab for your deployment.

  3. Edit the settings.

    1. Click Settings.

    2. Click Edit Settings.

To modify the legacy Monitoring Agent credentials:

  1. In MongoDB Cloud Manager, go to the Deployment page for your project.

    1. If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

    2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

    3. If the Deployment page is not already displayed, click Deployment in the sidebar.

      The Deployment page displays.

  2. Go to the Processes page.

    1. Click the Processes tab for your deployment.

  3. Modify the credentials.

    1. Click .

    2. Click Monitoring Settings.

    3. Click Credentials.

To modify the legacy Backup Agent credentials:

  1. In MongoDB Cloud Manager, go to the Continuous Backup page for your project.

    1. If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

    2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

    3. Click Continuous Backup in the sidebar.

    The Continuous Backup page displays.

  2. Edit the credentials.

    1. Click Overview.

    2. Click <Deployment to Backup>.

    3. Click under the Options`
      column.

    4. Click Edit Credentials.

5

Finish the installation of the MongoDB Agent.

At the Final Steps modal, the legacy Backup and Monitoring Agents are put into standby mode. Click Finish.

Next Steps

After the MongoDB Agent update completes:

Back

Update

Next

Legacy Monitoring Agents