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

  1. Download and decompress the SMC client package.
    1. 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.
    2. Upload the SMC client package to the migration source.
    3. 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.
      Client version
    4. 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.Home directory of the client
      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.
  2. 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
        • Specify the files or directories to be excluded:
          C:\MyDirs\Docs\Words
          C:\MyDirs\Docs\Excels\Report1.txt
        • Add the following information to the rsync_excludes_win.txt file:
          /MyDirs/Docs/Words/
          /MyDirs/Docs/Excels/Report1.txt
      • Data disk
        • Specify the files or directories to be excluded:
          D:\MyDirs2\Docs2\Words2
          D:\MyDirs2\Docs2\Excels\Report2.txt
        • Add the following information to the rsync_excludes_win_disk1.txt file:
          /MyDirs2/Docs2/Words2/
          /MyDirs2/Docs2/Excels2/Report2.txt
        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/):
        • Specify the files or directories to be excluded:
          /var/mydirs/docs/words
          /var/mydirs/docs/excels/report1.txt
        • Add the following information to the rsync_excludes_linux.txt file:
          /var/mydirs/docs/words/
          /var/mydirs/docs/excels/report1.txt
      • Data disk
        • Specify the files or directories to be excluded:
          /mnt/disk1/mydirs2/docs2/words2
          /mnt/disk1/mydirs2/docs2/excels2/report2.txt
        • Add the following information to the rsync_excludes_linux_disk1.txt file:
          /mydirs2/docs2/words2/
          /mydirs2/docs2/excels2/report2.txt
        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.
  3. Run the SMC client to import the migration source information.
    1. 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.
        • In the directory of the go2aliyun_client file, run the following commands as a root user:
          chmod +x go2aliyun_client
          ./go2aliyun_client
        • In the directory of the go2aliyun_client file, run the following commands as a sudo user:
          sudo chmod +x ./go2aliyun_client
          sudo ./go2aliyun_client
        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.
        • Run the following command as a root user:
          ./go2aliyun_client --accessid=<Your AccessKeyID> --secretkey=<Your AccessKeySecret>
        • Run the following command as a sudo user:
          sudo ./go2aliyun_client --accessid=<Your AccessKeyID> --secretkey=<Your AccessKeySecret>
    2. 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.Enter the AccessKey pair
        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.Install rsync
        • 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.Disable SELinux
    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.smcWhen 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.The migration source information is importedWhen 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.SMC4
  • 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.Import failure