Migration sources can be physical servers, VMware virtual machines (VMs), Xen, KVM,
or Hyper-V VMs, and VMs that run in public clouds. Before you use Server Migration
Center (SMC) for server migration, you must run the SMC client with your Alibaba Cloud
account on the migration source, and import the migration source information. Then,
you can log on to the SMC console to perform migration. This topic describes how to
import the information of a migration source.
Prerequisites
The preparations for using SMC are complete. For more information, see
Before you begin.
Procedure
- Download and decompress the SMC client package.
- Download the SMC client package.
If the migration source has access to the Internet, you can also download the SMC
client package to the migration source.
Note You can log on to the
SMC console. In the upper-right corner of the page, click
Download Latest SMC Client to download the latest version of the SMC client.
- Upload the SMC client package to the migration source.
- Decompress the SMC client package.
The SMC client is available for Windows and Linux of the 32-bit version (i386) and
the 64-bit version (x86_64). Select the version that is compatible with the migration
source. The following figure shows the decompressed client folders for Windows.
Note Linux systems run the unzip <name of the SMC client package> command. This allows you to decompress the SMC client package. Make sure that the
unzip utility is installed on the source server. For example, the installation command
for CentOS 7 is yum -y install unzip.

- Decompress the client package that is compatible with the operating system of your
source server.
The following figure shows the directories and files in the decompressed folder.

Table 1. SMC client folders and files
Folder or file |
Description |
go2aliyun_client.exe |
The executable file of the command-line interface (CLI) program for Windows. |
go2aliyun_gui.exe |
The executable file of the graphical user interface (GUI) program for Windows. For
more information, see Use the Windows GUI version of an SMC client.
|
go2aliyun_client |
The executable file of the CLI program for Linux. |
user_config.json |
The configuration file of the migration source and destination. |
Excludes |
The folder of the files and directories that are excluded from migration. |
client_data |
The migration data file. This includes the intermediate instance information and migration
progress.
|
- Optional. Exclude files or directories from migration.
Note If the source server supports block replication, you cannot exclude files or directories
from migration.
The configuration files are located in the
Excludes directory of the SMC client. If a configuration file is lost or deleted by accident,
you can create another one.
-
System disk configuration file: rsync_excludes_win.txt (for Windows servers) or rsync_excludes_linux.txt (for Linux servers)
-
Data disk configuration file: named by adding a suffix disk [disk index number] to the system disk, for example, rsync_excludes_win_disk1.txt (for Windows servers) or rsync_excludes_linux_disk1.txt (for Linux servers)
- Example 1: Exclude files or directories from migration of a Windows server
- System disk
- Data disk
Note
To exclude a Windows directory, perform the following operations:
- Remove the prefix of the directory (scr_path). In the preceding example, you must remove
D:
.
- Replace
\
with /
.
- Example 2: Exclude files or directories from migration of a Linux server
-
System disk (root directory/):
-
Note To exclude a Linux directory, you must remove the prefix of the directory (scr_path). In the preceding example, you must remove /mnt/disk1.
- Run the SMC client to import the migration source information.
- Enter the SMC client folder and run the SMC client.
- For Windows servers, use one of the following methods to run the SMC client:
- To run the Windows GUI version, double-click the go2aliyun_gui.exe file.
- To run the Windows CLI version, double-click the go2aliyun_client.exe file.
Note When you run the program, you must click OK to confirm that you have the administrator privilege.
- For Linux servers, run the SMC client as a root or sudo user.
If you have required permissions on the migration source system, you can also run
the following commands to import the migration source information. In this case, you
do not need to enter your AccessKey pair.
- Enter the AccessKey pair of your Alibaba Cloud account.
Note If the AccessKey pair you entered is invalid, open the user_config.json file, delete the access_id and secret_key values, and then run the client again.
- For Windows servers
- If you use the Windows GUI version, enter the AccessKey ID in the Access Id field, enter the AccessKey secret in the Secret Key field, and then click Start. For more information, see Use the Windows GUI version of the SMC client.
- If you use the Windows CLI version, enter the AccessKey ID and AccessKey secret, and then press
Enter
.
- For Linux servers
Enter the
AccessKey ID and
AccessKey secret, and then press
Enter
.

The following prompts may appear:
- The rsync tool is installed in most mainstream migration sources. If rsync is not
installed on the migration source, the SMC client displays a prompt. Enter yes to install rsync, as shown in the following figure.

- If SELinux is enabled on the migration source, you are prompted to disable SELinux.
Enter yes to disable SELinux, as shown in the following figure.

Notice Do not close the client until the migration is complete. Otherwise, the migration
source will be disconnected from the SMC console and the migration fails.
What to do next
- If Import Source Server [s-bxxxxxxxxxxxx] Successfully! appears, the migration source information has been imported to the SMC console. After
you import the information of a migration source for the first time, the SMC console
generates a migration source record. The migration source is in the Active state.
The default migration source name is <Migration source hostname + Migration source
IP address>, as shown in the following figure.
When the client-side program is running, log on to the SMC console to complete the
migration. For more information, see Step 2: Create and start a migration task.
When you import a migration source, SMC collects the information of the source server.
This includes CPU, memory, CPU utilization, memory usage, and private IP address.
You can click the migration source ID to view the information, as shown in the following
figure. After the migration task is completed, you can create an ECS instance by using
the information of the source server.
- If Error or Goto Aliyun Not Finished! appears, the migration source information has failed to be imported, as shown in
the following figure. We recommend that you find the root cause of the issue, and
then run the client again. For more information, see SMC FAQ.
