Migrate a MongoDB Community Deployment to Atlas
On this page
- OAuth 2.0 authentication for programmatic access to Cloud Manager is available as a Preview feature.
- The feature and the corresponding documentation might change at any time during the Preview period. To use OAuth 2.0 authentication, create a service account to use in your requests to the Cloud Manager Public API.
Overview
If you use MongoDB Community Edition but can't use general Atlas Live Migration due to network restrictions, you can migrate your MongoDB deployments to Atlas via Cloud Manager. To live migrate data from your MongoDB deployments to clusters in Atlas using Cloud Manager:
Add your deployments to Cloud Manager.
Add credentials for Monitoring.
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:
Have an existing deployment in MongoDB Community Edition.
Considerations
When you add your MongoDB Community deployment to Cloud 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 to help with the Live Migration process. It doesn't import your deployment's actual data.
To learn more about authentication credentials, see Authentication Use Cases.
Procedure
Perform this procedure for each of your MongoDB deployments.
Add your deployment to Cloud Manager.
Follow the procedure to Add MongoDB Processes.
Add credentials for Monitoring.
To add credentials for Monitoring:
Create the credentials to the deployment. See Required Access for Monitoring.
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 monitoring 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 Use Cases.
Follow the Live Migration Process to Atlas.
To migrate your deployment to Atlas once you've added it to Cloud Manager, follow the workflow in Migrate a Deployment to Atlas.