You were redirected from a different version of the documentation. Click here to go back.

Provision a Migration Host

To live migrate your Cloud Manager-managed MongoDB deployment to Atlas, provision a migration host.


The migration host is a server on which you install a dedicated MongoDB Agent. This MongoDB Agent configured for live migration automates live migration operations. It requires that you set its configuration option agentFeatureCloudMigrationEnabled to true.

The process of live migration in Cloud Manager relies on the MongoDB Agent. Install a dedicated MongoDB Agent on a separate server, known as the migration host, for each MongoDB deployment that you intend to live migrate to Atlas. A MongoDB Agent on the migration host runs a one-time migration of data from Cloud Manager to Atlas and reports the live migration status back to Cloud Manager.

You use the migration host to manage the Live Migration process of your Ops Manager-managed deployment to Atlas. You can’t use the migration host for any other purposes. If you plan to migrate more than one deployment, create a dedicated migration host for each of the deployments that you intend to migrate to Atlas.

After you provision the migration host, its server displays in Ops Manager under the Servers tab.

For the overview of live migration’s stages, see Workflow for Live Migration.


The live migration process is CPU- and disk-intensive, and requires a cloud instance or an on-premises server with enough compute and storage capacity. Contact MongoDB Support for help with estimating your migration host’s storage and compute capacity.

Supported Platforms for Migration Host

You can create a migration host for live migrating your data from Cloud Manager-managed deployments to Atlas on the following platforms:

  • Amazon Linux 2 (linux-x86_64-enterprise-amazon2)
  • ARM64 Ubuntu 16.04
  • ARM64 Ubuntu 18.04
  • ARM64 Ubuntu 20.04
  • Debian 10
  • Debian 8.1
  • Debian 9.2
  • PPC64LE RHEL 7.1
  • PPC64LE RHEL 8.1
  • PPC64LE Ubuntu 16.04
  • PPC64LE Ubuntu 18.04
  • RHEL 6.2
  • RHEL 7.0
  • RHEL 8.0
  • s390x RHEL 6.7
  • s390x RHEL 7.2
  • s390x SLES 12
  • s390x Ubuntu 16.04
  • s390x Ubuntu 18.04
  • SLES 12
  • SLES 15
  • Ubuntu 18.04
  • Ubuntu 20.04


The configuration of a migration host for Live Migration is not supported on Windows or macOS. You can still live migrate your data from a Windows- or macOS-based deployment to Atlas if you provision your migration host on one of platforms it supports.


Before provisioning a migration host, review the MongoDB Agent Prerequisites.


Install a MongoDB Agent configured for live migration on a separate server, known as the migration host. This MongoDB Agent configured for live migration facilitates migrations for each Cloud Manager-managed deployment you want to live migrate from Cloud Manager to Atlas.

Choose an operating system from the supported platforms for provisioning a migration host and then use the corresponding instructions to install a MongoDB Agent.


In Cloud Manager, click Deployment, then the Agents tab, then Downloads & Settings.


Under Automation, click your operating system and follow the instructions to install and run the agent.

For more information, see Install MongoDB Agent.


Edit the MongoDB Agent configuration file.

In the directory where you installed the MongoDB Agent, open the automation-agent.config file in your preferred text editor:

sudo vi /etc/mongodb-mms/automation-agent.config

Update the following configuration options:

Key Value
mmsGroupId ProjectID of your project.
Agent API key of your
mmsBaseUrl URL (hostname and port) of the Cloud Manager.
agentFeatureCloudMigrationEnabled true
cloudMigrationOplogPath Path to the oplog files for the Live Migration process.

The resulting changes to the automation-agent.config file configuration options should look like the following:

mmsGroupId=<Project ID>
mmsApiKey=<agent API key>
mmsBaseUrl=<application URL>
cloudMigrationOplogPath=<path to oplog>

Restart the agent.

Next Steps

Once you have provisioned the migration host, you can switch to Atlas to start the Live Migration process for your Cloud Manager-managed deployment to Atlas.