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

Migrate a MongoDB Community Deployment to Atlas

Overview

If you use MongoDB Community Edition but cannot use general Atlas Live Migration due to network restrictions, you can migrate your MongoDB deployments to Atlas via Cloud Manager or Ops Manager. To live migrate data from your MongoDB deployments to clusters in Atlas using Cloud Manager or Ops Manager:

  1. Add your deployments to Cloud Manager or Ops Manager.
  2. Add credentials for Monitoring.
  3. Follow the Live Migration Process to Atlas.

For detailed steps, see Procedure.

Prerequisites

Before you begin the Live Migration process from MongoDB Community to Atlas, you must:

Considerations

Credentials for Monitoring

When you add your MongoDB Community deployment to Cloud Manager or Ops Manager, you need to add credentials for Monitoring only, not for Automation or Backup. Adding your deployment for Monitoring imports your deployment’s metadata into Cloud Manager or Ops Manager to help with the Live Migration process. It does not import your deployment’s actual data.

To learn more about authentication credentials, see Authentication.

Setup Considerations

You can use Cloud Manager or Ops Manager to migrate your MongoDB deployments. However, Cloud Manager requires less setup than Ops Manager since it’s a hosted version of Ops Manager.

To migrate your deployment using Ops Manager, you need to install it locally and read and accept the Migration Agreement. You can read and accept the Migration Agreement for using Ops Manager when you start the Live Migration process in Atlas.

Procedure

Perform this procedure for each of your MongoDB deployments.

1

Add your deployment to Cloud Manager or Ops Manager.

Follow the procedure to Add MongoDB Processes.

2

Add credentials for Monitoring.

To add credentials for Monitoring:

  1. Create the credentials to the deployment. See Required Access for Monitoring.
  2. Add the credentials based on your project’s authentication mechanism. See Add Authentication Credentials to your Deployment.

Note

If you’re adding your MongoDB deployment to Cloud Manager or Ops Manager so that you can live migrate it to Atlas, you don’t need to add credentials for Automation and Backup. To learn more, see Authentication.

3

Follow the Live Migration Process to Atlas.

To migrate your deployment to Atlas once you’ve added it to Cloud Manager or Ops Manager, follow the workflow in Migrate a Deployment to Atlas.