Provision a Migration Host¶

On this page

Overview
Considerations
Prerequisites
Migration Host Resource Requirements
Procedure
Next Steps

To live migrate your MongoDB deployment managed in Ops 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 Ops 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 Ops Manager to Atlas and reports the live migration status back to Ops Manager.

To learn about starting a live migration from Ops 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.

Prerequisites¶

The migration host must use a 64-bit chip architecture and one of the following supported platforms:

Architecture	Distro/OS	5.0
x86_64	RHEL/Centos 7	check circle icon
	RHEL/Centos 8	check circle icon
	Amazon Linux 2	check circle icon
	SUSE12	check circle icon
	SUSE15	check circle icon
	Debian 9	check circle icon
	Debian 10	check circle icon
	Debian 11	check circle icon
	Ubuntu 18.x	check circle icon
	Ubuntu 20.x	check circle icon
ARM	RHEL/Centos 8	check circle icon
	Amazon Linux 2	check circle icon
PowerPC/ ppc64le	RHEL/ Centos 7	check circle icon
	RHEL/ Centos 8	check circle icon
zSeries/ 390x	RHEL 7	check circle icon
	RHEL 8	check circle icon
	Windows	check circle icon

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.

If Ops Manager is running in local mode, you must have outgoing access to the following server to download mongomirror.

translators-connectors-releases.s3.amazonaws.com

Migration Host Resource Requirements¶

The live migration process is CPU-intensive and requires sufficient network bandwidth. Use a cloud instance or an on-premises server with enough resources to help ensure a successful migration.

For a replica set migration, a host with 2-4 CPU cores and 4-8 GB of RAM is typically sufficient. For a sharded cluster migration, a host with 2-4 CPU cores per shard is typically sufficient. Avoid host environments that have been characterized as having low network bandwidth.

You may also need to provision additional storage for the cloudMigrationOplogPath option described in the following procedure.

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.¶

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
```

Add or update the following live migration configuration options:

Key	Value
`agentFeatureCloudMigrationEnabled`	`true`
`cloudMigrationOplogPath`	Path to the oplog files for the live migration process. This key is optional and if set, requires provisioning enough storage in the specified directory for the oplog buffering. Contact MongoDB Support if you need assistance determining whether you need to set this key for your deployment.

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>
mmsBaseUrl=<The URL of your Ops Manager application>
agentFeatureCloudMigrationEnabled=true
cloudMigrationOplogPath=<The path to the oplog files>

To learn more, see MongoDB Agent Settings.

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.

← Provision Servers for Automation Add Existing MongoDB Processes to Ops Manager →