- Migrate Deployments >
- Migrate from Ops Manager to Atlas
Migrate from Ops Manager to Atlas¶
On this page
New in Ops Manager version 5.0
Overview¶
To live migrate data from the Ops Manager-managed deployments to clusters in Atlas, you:
- Prepare a cluster in MongoDB Atlas.
- Provision a migration host in Ops Manager and connect Ops Manager to Atlas.
- Start the live migration process in Atlas.
You begin the process in Atlas, by running the live migration wizard. Depending on the stage in the process, you perform the live migration steps either in Atlas or in Ops Manager. See Workflow for Live Migration.
To live migrate your MongoDB Community deployments to Atlas using Ops Manager, see Migrate a MongoDB Community Deployment to Atlas.
Restrictions¶
You can’t select an M0
free cluster or M2/M5
shared cluster
as the source or target for Live Migration. To migrate data from an
M0
free cluster or M2/M5
shared cluster to a paid cluster,
see Modify a Cluster.
Prerequisites¶
Before you begin the live migration process, follow these prerequisites.
Request an External IP Address¶
Request an external IP address for Ops Manager from your network administrator. When you are ready to live migrate data, Atlas uses this address for a link-token it generates. When you run live migration, you push the data from a live deployment in Ops Manager to a provisioned cluster in Atlas using the link-token. You generate this link-token in Atlas in Stage 1 of the live migration process. To learn more, see Live Migrate Your Data from Ops Manager or Cloud Manager.
Consider Configuring a VPC Peering Connection or Private Endpoints¶
The following table lists the current support status for VPC peering and private endpoints for source and target clusters that you live migrate to MongoDB Atlas.
Note
If you choose not to use VPC peering or private endpoints, the live migration process runs over public IP addresses that you add to the MongoDB Atlas project’s IP access list as part of the live migration procedure. To learn more, see Live Migrate Your Data from Ops Manager or Cloud Manager.
Cloud Provider | VPC Peering | Private Endpoints |
---|---|---|
Azure | check icon | check icon star icon |
AWS | check icon | check icon star icon |
GCP | check icon | check icon star icon |
Important
star icon Sharded clusters, multi-region clusters, and multi-cloud clusters don’t support live migration through private endpoints. Private endpoints are supported ONLY for live migration of replica sets deployed within a single cloud provider and single region.
To enable private endpoints with live migration on Azure, AWS, or GCP on replica sets deployed within a single cloud provider and single region:
- Configure a private endpoint between the migration host and the target MongoDB Atlas cluster and then choose the Private Endpoint connection type in MongoDB Atlas in the live migration procedure for replica sets.
To enable VPC peering with live migration on Azure, AWS, or GCP on replica sets or sharded clusters:
- Configure a VPC peering connection between the migration host and the target MongoDB Atlas cluster, and then choose the VPC Peering connection type when running live migration for replica sets or sharded clusters. To learn more, see Live Migrate Your Data from Ops Manager or Cloud Manager.
Create a Cluster in Atlas¶
Perform these tasks in Atlas:
- Create an Atlas account.
- Create an Atlas organization.
- Create a project in this organization.
- Create a new cluster in your project.
Workflow for Live Migration¶
The following diagram describes the stages in the live migration workflow.

The stages in the live migration workflow are:
- Stage 1: Link with Atlas. Perform this step in Atlas,
after provisioning a cluster.
- In the left-side panel of your organization’s page, click Live Migration.
- Select Migrate from Ops Manager or Cloud Manager and start the live migration wizard.
- If you are migrating from MongoDB Community using Ops Manager, read and accept the Ops Manager Migration Agreement.
- In the Generate Link-Token step of the wizard, specify the external IP address for Ops Manager that you obtained from your service administrator. See Prerequisites.
- Stage 2: Provision Migration Host.
- In Ops Manager, provision a Migration Host. A migration host is a dedicated MongoDB Agent that orchestrates the live migration process from Ops Manager to Atlas.
- In the Live Migration: Connect to Atlas section of your Ops Manager organization’s Settings page, select Connect to Atlas and enter the the link-token that you created in Atlas.
- Stage 3: Start the Migration. In Atlas, follow the steps in the wizard to start the live migration process.
To learn more, see Live Migrate Your Data from Ops Manager or Cloud Manager.
Supported Platforms¶
Live migration to Atlas is supported for all platforms on which you can provision a migration host. Provisioning of the migration host is supported on all platforms except for Windows or macOS. You can still live migrate your data from a Windows-based deployment to Atlas if you provision your migration host on one of its supported platforms. You can’t live migrate your data from a macOS-based deployment to Atlas.