- Migrate Deployments >
- Migrate from Cloud Manager to Atlas
Migrate from Cloud Manager to Atlas¶
On this page
Overview¶
To live migrate data from the Cloud Manager-managed deployments to clusters in Atlas, you:
- Prepare a cluster in MongoDB Atlas.
- Provision a migration host in Cloud Manager and connect Cloud 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 Cloud Manager. See Workflow for Live Migration.
To live migrate your MongoDB Community deployments to Atlas using Cloud Manager, see Migrate a MongoDB Community Deployment to Atlas.
Restrictions¶
You cannot select an
M0free cluster orM2/M5shared cluster as the source or target for Live Migration. To migrate data from anM0free cluster orM2/M5shared cluster to a paid cluster, see Modify a Cluster.The following table lists the current support status for VPC peering and VPC private endpoints for source and target clusters that you live migrate from Cloud Manager to MongoDB Atlas:
Cloud Provider VPC Peering VPC Private Endpoints Azure minus icon minus icon AWS check icon minus icon GCP minus icon minus icon To request support for additional providers, submit a request on the MongoDB Feedback page.
Prerequisites¶
Before you begin the Live Migration process, follow these prerequisites.
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 in MongoDB Atlas, click Live Migration.
- Select Migrate from Ops Manager or Cloud Manager and start the Live Migration wizard.
- In the Generate Link-Token step of the wizard, create the link-token. You will use this link-token in the next stage.
- Stage 2: Provision Migration Host.
- In Cloud Manager, provision a Migration Host. A migration host is a dedicated MongoDB Agent that orchestrates the live migration process from Cloud Manager to Atlas.
- In the Live Migration: Connect to Atlas section of your Cloud 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.