tencent cloud

Overview

This document describes how to migrate the system and applications from a source server in your IDC or a cloud platform to the specified CVM instance through the online migration in the console.

Note

The source server can be a physical server, a virtual machine, or a cloud server on another cloud platform, such as AWS, Google Cloud Platform, VMware, Alibaba Cloud, or Huawei Cloud.

Directions

Prerequisites

• You have a Tencent Cloud account.
• If you want to use a sub-account to perform migration in the console, you need to log in to the CAM console with the root account and associate the QcloudCSMFullAccess policy with the sub-account.
• You can create a key and obtain the SecretId and SecretKey in API Key Management.
• Click here to download the compressed migration tool package.
• Stop applications on the source server to prevent existing applications from being affected by the migration.

Data Backup

• Source server: You can use the source server snapshot feature or other methods to back up data.
• Destination CVM: You can create a snapshot or use other methods to back up data.

Getting migration tool

Click here to obtain the compressed migration tool package.

Checking Before the Migration

Before migration, you need to check the source server and destination CVM separately as detailed below:

Note

• You can use tool commands such as sudo ./go2tencentcloud_x64 --check to automatically check the source server.
• By default, the go2tencentcloud migration tool automatically performs checks upon launch. To skip checks and perform forced migration, configure Client.Extra.IgnoreCheck to true in the client.json file.
• For more information on the go2tencentcloud migration tool, see Compatibility and Tool Configuration Description.

Starting migration

1. Download or upload go2tencentcloud.zip to the source server and run the following command to enter the corresponding directory.
   i. Run the following commands in sequence to decompress go2tencentcloud.zip and enter the directory.

   unzip go2tencentcloud.zip
   

cd go2tencentcloud

ii. Run the following commands in sequence to decompress go2tencentcloud-linux.zip and enter the directory.

unzip go2tencentcloud-linux.zip

cd go2tencentcloud-linux

Note

The files in the go2tencentcloud directory will not be migrated. Do not place the files to be migrated in this directory.

2. (Optional) Exclude files and directories on the source server that do not need to be migrated.
   If there are files or directories on the Linux source server that do not need to be migrated, you can add them to the rsync_excludes_linux.txt file.

3. Import the migration source.
   i. For example, on a 64-bit Linux source server, execute the following command in sequence as the root user to run the tool.

   chmod +x go2tencentcloud_x64
   

sudo ./go2tencentcloud_x64

Enter the SecretId and SecretKey of the account API access key obtained in Prerequisites and press Enter as shown below:


If the information in the following figure is displayed in the window of the migration tool, the migration source has been imported to the console successfully, and you can go to the console to view it:


You can log in to the CVM console and enter the online migration page to view the imported migration source, whose status is Online as shown below:

If "Import source server successfully" isn't displayed, the migration source failed to be imported, and you can view the log (which is the logs/log file in the migration tool directory by default) for troubleshooting. Then, run the migration tool to import the migration source again.

Note

After the migration source is imported successfully, don't close the migration tool in the instance until the migration task is completed; otherwise, the migration task can't be completed after the migration source becomes offline.

4. Go to the online migration page in the CVM console to create a migration task.
   i. Log in to the CVM console, go to the online migration page, and click Create Migration Task on the right of the desired migration source.
   ii. In the Create Migration Task pop-up window, configure the task as instructed in Migration Task Configuration Description.
   For example, to migrate a Linux source server to a CVM instance in the Guangzhou region of Tencent Cloud, you can configure the migration task as shown below:
   
5. Start the migration task

   Note

   You can skip this step if your task is scheduled, which will automatically start running at the scheduled execution time.

   After creating a migration task, you can click the Migration Task tab to view the task as shown below: You can click Start/Restart on the right of the task to start it, click OK in the pop-up window, and the task status will become Migrating as shown below:
6. Wait for the migration task to end
   After the migration task status becomes Successful, the migration is completed successfully as shown below:
   

Checking after the Migration

• If the migration fails, check the error information in log files (under the migration tool directory by default), operation guides, or FAQs about Service Migration for troubleshooting methods. After troubleshooting, click Restart under the operation column to restart the migration task.
• If the migration is successful, check whether the destination CVM starts up normally, whether data on the destination CVM is consistent with that on the source server, and whether the network and other system services are normal.

If you have any questions or the migration has an exception, see FAQs about Service Migration or Contact Us.