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

Provision a Migration Host

On this page

To live migrate your MongoDB deployment managed in Cloud Manager to Atlas, provision a server for the migration host.

Overview

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

You use the migration host to manage the Live Migration process of your deployment from Cloud Manager to Atlas. You can’t use the migration host for any other purposes.

After you provision the migration host, its server appears under the Servers tab. 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.

To learn about starting a Live Migration from Cloud Manager, see Migrate a Deployment to Atlas and review the workflow for Live Migration to Atlas.

Considerations

If you plan to migrate more than one deployment at a time, create a dedicated migration host for each of the deployments that you want to migrate to Atlas.

The Live Migration process is CPU-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.

Prerequisites

The migration host must use a 64-bit chip architecture and one of the following supported 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

Note

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 the platforms it supports.

Procedure

1

Click Deployment, select the Agents tab, and then select Downloads & Settings.

2

Under Automation, select your operating system and follow the instructions to install and run the agent on the migration host.

To learn more, see Install the MongoDB Agent to Only Monitor or Backup Deployments.

3

Edit the MongoDB Agent configuration file to enable Live Migration.

  1. If you don’t already have the automation-agent.config file open from the previous step, open it in your preferred text editor:

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

  2. Add or update the following Live Migration configuration options:

    Key Value
    agentFeatureCloudMigrationEnabled true
    cloudMigrationOplogPath Path to the oplog files for the Live Migration process. Contact MongoDB Support for help.

  3. Ensure that the resulting changes to the automation-agent.config file contain the following necessary configuration options for Live Migration:

copy 
mmsGroupId=<The ID of your project>
mmsApiKey=<The Agent API key of your project>
agentFeatureCloudMigrationEnabled=true
cloudMigrationOplogPath=<The path to the oplog files>
4

Restart the MongoDB Agent to incorporate the updated settings.

An additional server appears under the Servers tab, and an additional MongoDB Agent appears under the Agents tab.

Next Steps

Once you have provisioned the migration host, you can switch to Atlas and follow the steps in the wizard to start the Live Migration process.

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.