Migrate Deployments
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.
Important
Live Migration (push) Deprecated or Not Supported for Source Deployments Managed or Monitored by Ops Manager
For source deployments running any MongoDB 6.0.+ versions, where the deployments are managed or monitored by Ops Manager, live migration (push) is not supported.
For source deployments running any MongoDB 5.0 and earlier versions, where the deployments are managed or monitored by Ops Manager, live migration (push) is deprecated.
For source deployments running MongoDB 6.0.+, where the deployments are monitored by Cloud Manager, live migration (push) is supported. To learn more, see Live Migrate Your MongoDB Cluster Monitored by Cloud Manager to Atlas.
MongoDB 6.0.8 and Later: Live Migrate to Atlas
If both the source and destination clusters are running MongoDB 6.0.8 or later, you can migrate your data from a source cluster into a destination MongoDB cluster in Atlas using one of the following types of guided live migration in the MongoDB Atlas UI:
Live migration (push). For instructions, see Live Migrate Your MongoDB Cluster Monitored by Cloud Manager to Atlas.
Live migration (pull). For instructions, see Live Migrate (Pull) a MongoDB Cluster into Atlas.
The choice between push and pull live migrations depends on whether the network for your deployment allows flexibility in ingress rules and allows access through the firewall.
In addition, you can use these migration methods for MongoDB 6.0.8 and later deployments:
If your data is in a MongoDB deployment and you don't have access to the oplog, You can use
mongorestoreto run a self-managed migration. To learn more, see Seed with mongorestore.If your data is in Cloud Manager and you have a snapshot, you can restore a backup of a deployment to an Atlas deployment.
Earlier MongoDB Versions: Live Migrate to Atlas
If you are migrating MongoDB versions earlier than 6.0.8, use one of the following migration methods, depending on your deployment's requirements and configuration.
Deployment Configuration | Migration Strategy |
|---|---|
Your data is in a cluster running MongoDB earlier than 6.0.8,
is managed or monitored by Cloud Manager and your network allows flexibility in
ingress rules. | Pull data into Atlas
from Cloud Manager. In this type of live migration, Atlas
requires access to the source deployment in Cloud Manager through
the deployment's firewall. |
Your data is in a cluster running MongoDB earlier than 6.0.8,
your cluster is managed or monitored by Cloud Manager, and your network doesn't
allow flexibility in ingress rules. | Push your data into Atlas from Cloud Manager.
In this type of live migration, Atlas receives data from
Cloud Manager without requiring access through the firewall. |
Your data is in a MongoDB Community cluster running MongoDB earlier than 6.0.8,
and your network doesn't allow flexibility in ingress rules. | Push your MongoDB Community data into Atlas
after adding your Community deployment to Cloud Manager for monitoring.
In this type of live migration, Atlas receives data from
Cloud Manager without requiring access through the firewall. |
Your data is in Cloud Manager and you have a snapshot. | |
Your data is in a MongoDB deployment and you don't have access to the oplog. | Use mongorestore to run a self-managed migration.
To learn more, see Seed with mongorestore. |