All Products
Search
Document Center

Server Migration Center:Use the SMC plug-in of Cloud Assistant to import the information of a source server

Last Updated:Sep 07, 2023

If you have installed a Cloud Assistant client on your source server, you can use the SMC plug-in to import the information of the source server in a convenient and efficient manner. This topic describes how to use the SMC plug-in to import the information of a source server in Linux and Windows.

Prerequisites

  • The preparations for using SMC are completed. For more information, see Before you begin.

  • A Cloud Assistant client later than 2.2.1.107 is installed on the source server.

    • If your source server is an ECS instance, a Cloud Assistant client is installed by default. You can call the DescribeCloudAssistantStatus API operation to view the version of the Cloud Assistant client installed on the ECS instance. If you are using an early version of Cloud Assistant, you must upgrade the client to a version later than 2.2.1.107. For more information, see Upgrade or disable upgrades for the Cloud Assistant Agent.

    • If your source server is not an ECS instance, you must manually install a Cloud Assistant client later than 2.2.1.107. For more information, see Install Cloud Assistant Agent.

Background information

To ensure stable migration, we recommend that you exclude directories that store dynamic data, such as the data directories of large databases. Then, you can stop the services that are running on the server and start the migration task. For information about how to exclude directories that store dynamic data without stopping services, see Step 1: Import the information of a migration source.

Note

If the data stored on the source server is required after migration, you can save the data and upload it to the destination server.

Import the information of the source server in Linux

  1. Run the following command to view the list of Cloud Assistant plug-ins and make sure that the plug-ins are available:

    acs-plugin-manager -l

    The following command output indicates that the smc-client-plugin plug-in is available. smc-client-plugin-linux

  2. Run the following command to import the information in Linux:

    acs-plugin-manager -e -P smc-client-plugin -p --accessid=<AccessKey ID>,--secretkey=<AccessKey Secret>,--nocheckversion

    <AccessKey ID> and <AccessKey Secret> indicate the AccessKey pair of your Alibaba Cloud account. Make sure that you have created an AccessKey pair. For more information, see Create AccessKey pairs.

    The following command output indicates that the information of the source server is imported. smc-success-linux

    After the information of the source server is imported, SMC automatically generates a record for the migration source. You must create and start a migration task for the migration source in the SMC console. For more information, see Create a server migration job.

Import the information of the source server in Windows

  1. Go to the installation directory of the Cloud Assistant client.

    • If your source server is an ECS instance, the default installation directory of the Cloud Assistant client is C:\ProgramData\aliyun\assist\<Cloud Assistant version number>, for example, C:\ProgramData\aliyun\assist\2.1.1.140.

      Note

      The C:\ProgramData folder is hidden. Therefore, you must show hidden folders in advance. You must also ensure the data security of this folder to prevent system exceptions caused by unintentional errors.

    • If your source server is not an ECS instance, you must go to the installation directory of the Cloud Assistant client.

  2. In the installation directory of the Cloud Assistant client, press the Shift key and right-click the blank area at the same time. Then, click Open command window here.

  3. Run the following command to view the list of Cloud Assistant plug-ins and make sure that the plug-ins are available:

    acs-plugin-manager.exe -l

    The following command output indicates that the smc-client-plugin plug-in is available. smc-client-plugin-win

  4. Run the following command to import the information in Linux:

    acs-plugin-manager.exe -e -P smc-client-plugin-win -p --accessid=<AccessKey ID>,--secretkey=<AccessKey Secret>,--nocheckversion

    <AccessKey ID> and <AccessKey Secret> indicate the AccessKey pair of your Alibaba Cloud account. Make sure that you have created an AccessKey pair. For more information, see Create AccessKey pairs.

    Then, a command window appears. The following command output indicates that the information of the source server is imported. addadada

    After the information of the source server is imported, SMC automatically generates a record for the migration source. You must create and start a migration task for the migration source in the SMC console. For more information, see Create a server migration job.