Use DTS to migrate MongoDB databases between different Alibaba Cloud accounts

Background information

This topic describes how to use DTS to migrate data from one Alibaba Cloud account to another. You can perform full data migration or incremental data migration by setting the source instance type to User-Created Database with Public IP Address.

Prerequisites

• The source instance must be a standalone instance or replica set instance. If the source instance type is sharded cluster, see Use mongodump and mongorestore to migrate databases.
  Note DTS does not support incremental data migration of standalone instances.
• The storage space of the destination instance must be larger than the occupied storage space in use of the source instance.

Precautions

We recommend that you migrate your data during off-peak hours to avoid business interruptions.

The data in the admin database cannot be migrated even if it is selected as a migration object.

Billing information

Migration type description

• Full data migration: All data from the source instance database is migrated to the destination instance database.
  • Migrates databases.
  • Migrates collections.
  • Migrates indexes.
• Incremental data migration: The incrementally updated data of the source database is synchronized to the database in the destination instance on the basis of full data migration.
  • Synchronizes the create and delete operations on databases.
  • Synchronizes the create, delete, and update operations on documents.
  • Synchronizes the create and delete operations on collections.
  • Synchronizes the create and delete operations on indexes.

Migration permission requirements

If you use DTS to migrate MongoDB databases, you need different permissions when performing different types of migration. The details are as follows:

Premigration preparation for the source instance

1. Log on to the ApsaraDB for MongoDB console with the Alibaba Cloud account to which the source instance belongs.
2. Apply for a public IP address to connect to the source instance through the Internet. For more information, see Apply for a public address.
3. Obtain required information from DTS CIDR blocksand add the CIDR block of the destination instance to the whitelist of the source instance. For more information, see Configure a whitelist.

   For example, the source instance is located in Hangzhou and the destination instance is located in Shenzhen, add the DTS CIDR block of Shenzhen to the whitelist.

Premigration preparation for the destination instance

If you migrate data to a sharded cluster instance, we recommend that you shard the data as needed. For more information, see Configure sharding to maximize the performance of shards.

Migration procedure

1. Log on to the DTS console with the Alibaba Cloud account to which the destination instance belongs.
2. In the left-side navigation pane, click Data Migration.
3. In the upper-right corner of the Data Migration page, click Create Migration Task.
4. Configure Source and Destination Databases of the migration task.

   Parameter	Description
   Task Name	DTS automatically generates a name for each task. Task names are not required to be unique. You can modify task names as needed. We recommend that you specify meaningful names for the tasks to help identify the tasks.
   Source Database	Instance Type: Select User-created Database with Public IP Address. Database Type: Select MongoDB. Hostname or IP Address: Enter the domain of the public IP address of the source instance. For example, dds-1udxxxxxxx-pub.mongodb.rds.aliyuncs.com. Port Number: Enter the service port 3717 of the source instance. Database Name: Enter the name of the authentication database in the source instance. Database Account: Enter the account of the database in the source instance. For more information, see Migration permission requirements. Database Password: Enter the password of the Database Account.
   Destination Database	Instance Type: Select MongoDB Instance. Instance Region: Select the region where the destination instance is located. MongoDB Instance ID: Select the ID of the destination instance. Database Name: Enter the name of the authentication database in the destination instance. The default name is admin. Database Account: Enter the database account of the destination instance. For the permission requirement, see Migration permission requirements. Database Password: Enter the password of the Database Account.

5. After configuring the parameters, click Set Whitelist and Next in the lower-right corner.
   Note The IP address of the DTS server is automatically added to the whitelist of the destination instance.This ensures that the DTS server can connect to the destination instance. After the migration is complete, you can delete the whitelist if you no longer need it. For more information, see Configure a whitelist.
6. Configure the migration objects and migration types.

   Parameter	Description
   Migration Types	If you need to migrate all of the data, select Full Data Migration for Migration Types. Note To ensure data consistency, do not write new data into the source instance during full data migration. If you need to migrate the data without stopping businesses, select Full Data Migration and Incremental Data Migration for Migration Types.
   Migration Objects	Select the database to be migrated from the Available area and click the icon to add the database to the Selected area. Note The data in the admin database cannot be migrated even if it is selected as a migration object. The migration object can be a database or a collection/function. After an object is migrated to ApsaraDB for MongoDB, the object name in ApsaraDB for MongoDB is the same as that in the source database. Note If the migrated object has different names in the source instance and the destination instance, you can use the object name mapping function provided by DTS. For more information, see Object name mapping.

7. When you complete the preceding configurations, click Precheck in the lower-right corner.
   Note

   • A precheck is performed before the migration task starts. The migration starts only after the precheck succeeds.
   • If the precheck fails, click the icon corresponding to the check items to view their details. Perform a precheck again after the problems are rectified.
8. After the precheck succeeds, click Next.
9. On the Confirm Settings page, set Channel Specification and select Data Transmission Service (Pay-As-You-Go) Service Terms.
10. Click Buy and Start to start the migration.
    • Full data migration

      Wait until the migration task stops automatically.

    • Incremental data migration
      The migration task does not stop automatically. To stop the migration task, wait until the task is in the Incremental Migration without Delay state, and stop writing to the source database. After a few minutes, the task enters the Incremental Migration without Delay state again, and you can stop the task.

Switch your businesses to the ApsaraDB for MongoDB instance during off-peak hours to avoid negatively affecting your businesses.

More information