Navigation
You were redirected from a different version of the documentation. Click here to go back.

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.

    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, navigate to Deployment arrow right icon Security arrow right icon Authentication & TLS arrow right icon Edit Settings.
    • The legacy Monitoring Agent credentials can be modified from Deployment arrow right icon Processes arrow right icon ellipsis icon arrow right icon Monitoring Settings arrow right icon Credentials.
    • The legacy Backup Agent credentials can be modified from Continuous Backup arrow right icon Overview arrow right icon <Deployment to Backup> arrow right icon ellipsis icon under Options column arrow right icon 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:

    © MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.