Connect to Atlas for Live Migration
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.
In Stage 2 of the Live Migration workflow, you must connect from Cloud Manager to Atlas.
To connect an organization in Cloud Manager to Atlas, enter the link-token that you generated in Atlas into the Settings page of your Cloud Manager organization.
Use one link-token per Cloud Manager organization. If you have other organizations in Cloud Manager that contain deployments you want to migrate, create a link-token in Atlas for each organization and then specify it in the corresponding organization's settings. You can run Live Migration processes in parallel for each Cloud Manager organization connected to Atlas. For each organization, you can use the same link-token to live migrate that organization's deployments from Cloud Manager to Atlas, one at a time.
Prerequisites
Before you connect to Atlas:
Review the workflow for Live Migration to Atlas.
Complete Stage 1: Generate a link-token in Atlas.
If you are migrating from Ops Manager, verify that you specified an external IP address of the Cloud Manager instance to Atlas. To learn more, see Prerequisites for Live Migration.
Procedure
In MongoDB Cloud Manager, go to the Organization Settings page.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
Click the Organization Settings icon next to the Organizations menu.
The Organization Settings page displays.
Connect to Atlas.
In the Organization Settings, the General Settings tab displays the configurable settings for the organization.
Click the General Settings tab.
In the Live Migration: Connect to Atlas section, click Connect to Atlas. The Connect to Atlas dialog opens.
Paste the link-token that you copied from Atlas. The link-token contains details of your connection to Atlas.
Click Connect to Atlas.
Next Steps
Once you connect to Atlas, you can provision a migration host.