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.

Migrate a MongoDB Deployment to a New Project

On this page

You can migrate a MongoDB deployment from one Ops Manager project to another project.


Historic metrics for the MongoDB deployment don’t migrate to the new project.



Optional: Download snapshots.

If you have backup enabled and want to retain snapshots:

  1. Download any snapshots that you want to keep:

  2. Stop all backups.


    All existing snapshots remain available for download until they expire, but Ops Manager captures no new snapshots.


Optional: Prepare backup components.

If you want backup enabled for your MongoDB deployment in the new project, prepare your backup components.


Prepare the new project.

  1. Create a new project to use as the destination project.
  2. Click Settings in the left navigation.
  3. Note the Project ID value on the Project Settings tab.
  4. Create a new Agent API key.

Prepare the MongoDB Agent.


If you have multiple deployments in your project and a MongoDB Agent installed only on the hosts that you plan to move, you must install new agents on servers that you will not move to the new project.

  1. Stop the MongoDB Agent.

  2. Edit the MongoDB Agent configuration file to update the mmsGroupId and mmsApiKey settings with the values from for the new project.

  3. (Optional) If the new project is a new Ops Manager, update the mmsBaseUrl setting.

  4. Start the MongoDB Agent.

    The MongoDB deployment servers should appear on the Servers and Agents tabs.


Optional: Remove the old project.


This step permanetly deletes your old project and its related artifacts.

  1. Terminate all backups in the old project.


    If you don’t terminate all backups in the old project, all existing snapshots remain available for download until they expire and occupy disk space. You can’t remove the MongoDB deployment and delete the old project unless your terminate all backups.

  2. Completely remove the MongoDB deployment from the old project.

  3. Delete the old project.