- Migrate Deployments >
- Migrate a MongoDB Community Deployment to Atlas
Migrate a MongoDB Community Deployment to Atlas¶
On this page
Overview¶
Live Migration (push) Deprecated for Source Deployments Managed or Monitored by Ops Manager
Live migration (push) is deprecated for source deployments managed or monitored by Ops Manager. You can only use live migration (push) for deployments that you monitor in Cloud Manager, not in Ops Manager. Live migration (push) for source deployments monitored by Cloud Manager also supports MongoDB 6.0+. To learn more, see Live Migrate Your MongoDB 6.0.8 or Later Cluster Monitored by Cloud Manager to Atlas.
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 or Ops 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.
- Start a free trial of Cloud Manager.
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 Use Cases.
Setup Considerations¶
You can use Cloud Manager to migrate your MongoDB deployments.
Live Migration (push) Deprecated for Source Deployments Managed or Monitored by Ops Manager
Live migration (push) is deprecated for source deployments managed or monitored by Ops Manager. You can only use live migration (push) for deployments that you monitor in Cloud Manager, not in Ops Manager. Live migration (push) for source deployments monitored by Cloud Manager also supports MongoDB 6.0+. To learn more, see Live Migrate Your MongoDB 6.0.8 or Later Cluster Monitored by Cloud Manager to Atlas.
For deployments running MongoDB 6.0.8 or later, you can only use Cloud Manager, not Ops Manager, to monitor them if you want to live migrate (push) them to Atlas. You can migrate such deployments to Atlas using live migration (pull). For a detailed overview of live migration options, see Migrate to Atlas.
Procedure¶
Perform this procedure for each of your MongoDB deployments.
Add your deployment to Cloud Manager or Ops 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 or Ops Manager, follow the workflow in Migrate a Deployment to Atlas.