操作场景

您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云的AK/SK，迁移Agent启动成功后会自动收集源端服务器信息并发送给主机迁移服务。

可以通过两种方式下载迁移Agent：

• 方式一：在源端服务器中通过命令直接下载迁移Agent。推荐使用方式一安装Linux版的SMS-Agent。
• 方式二：通过主机迁移服务页面下载迁移Agent，再使用远程传输工具如WinSCP将迁移Agent上传到待迁移的源端服务器。

前提条件

• 已获取目的端服务器所在华为云账号的AK/SK。
  • 如果您使用IAM用户进行迁移，具体请参见如何获取AK/SK?（IAM用户）。
  • 如果您直接使用账号进行迁移，具体请参见如何获取AK/SK?（账号）。

• 源端服务器的OS类型需要包含在兼容性列表中。

安装Linux版的SMS-Agent（方式一）

1. 使用PuTTY或者SSH客户端，以root用户登录待迁移的源端服务器。
2. 执行以下任意命令，下载迁移Agent。

   wget -t 3 -T 15 https://sms-agent-bucket.obs.cn-north-1.myhuaweicloud.com/SMS-Agent.tar.gz

   curl -O https://sms-agent-bucket.obs.cn-north-1.myhuaweicloud.com/SMS-Agent.tar.gz

3. （可选）对迁移Agent进行软件完整性校验，具体参见如何对迁移Agent进行软件完整性校验？。
4. 执行以下命令，解压软件包。

   tar -zxvf SMS-Agent.tar.gz

5. 执行以下命令，进入源端服务器的SMS-Agent目录。

   cd SMS-Agent

6. 若使用HTTPS代理服务器，请执行7。

   若不使用HTTPS代理服务器，请执行8。

   

   代理服务器为一种特殊网络服务，当您的源端无法通过公网访问华为云时，可以通过代理服务器访问华为云，代理服务器需用户自行配置。

7. 配置HTTPS代理服务器（可选）。
   1. 执行如下命令，进入config目录。

      cd SMS-Agent/config

   2. 执行如下命令，打开并编辑auth.cfg文件。

      vi auth.cfg

      图1 安装Linux版的SMS-Agent
      
      

      • proxy_addr为代理服务器地址，允许源端服务器通过代理服务器访问主机迁移服务，非目的端地址。
      • 若迁移过程中不使用HTTPS代理，禁止修改auth.cfg文件。
      • 代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。
      • 使用代理时，enable设置为true。
      • 代理有用户名的话，proxy_user就填写用户名，如root；没有则不填。
      • 代理有密码的话，use_password设置为true，否则false。
      • 以上示例仅为示例说明，具体代理服务器信息，请根据实际情况填写。
   3. 执行如下命令，保存auth.cfg文件并退出。

      :wq

8. 执行以下命令，启动迁移Agent。

   ./startup.sh

9. 请您仔细阅读显示的内容并输入“y”，按“Enter”。
   图2 输入y
   

10. 根据提示，输入目的端服务器所在华为云账号的AK和SK。

    当出现如下界面时，表示Linux版的SMS-Agent启动成功，开始给主机迁移服务上传源端服务器信息。

    图3 输入AK/SK值
    

安装Linux版的SMS-Agent（方式二）

1. 登录目的端管理控制台。
2. 单击“服务列表”，选择“迁移 > 主机迁移服务”。

   进入“主机迁移服务”页面。

3. 在左侧导航树中，选择“迁移Agent”。

   进入“迁移Agent”页面。

4. 单击Linux Agent下载窗格中的“下载”。

   下载“SMS-Agent”文件。

5. （可选）对迁移Agent进行软件完整性校验，具体参见如何对迁移Agent进行软件完整性校验？。
6. 使用远程传输工具如WinSCP将迁移Agent上传到待迁移的源端服务器。
7. 使用PuTTY或者SSH客户端，以root用户登录待迁移的源端服务器。
8. 执行以下命令，解压软件包。

   tar -zxvf SMS-Agent.tar.gz

9. 执行以下命令，进入源端服务器的SMS-Agent目录。

   cd SMS-Agent

10. 若使用HTTPS代理服务器，请执行11。

    若不使用HTTPS代理服务器，请执行12。

11. 配置HTTPS代理服务器（可选）。
    1. 执行如下命令，进入config目录。

       cd SMS-Agent/config

    2. 执行如下命令，打开并编辑auth.cfg文件。

       vi auth.cfg

       [auth-info]
       mainRegion = cn-north-1
       
       
       [proxy-config]
       enable = true
       proxy_addr = 192.168.1.10
       proxy_port = 3128
       proxy_user = root
       use_password = true

       

       • proxy_addr为代理服务器地址，允许源端服务器通过代理服务器访问主机迁移服务，非目的端地址。
       • 若迁移过程中不使用HTTPS代理，禁止修改auth.cfg文件。
       • 代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。
       • 使用代理时，enable设置为true。
       • 代理有用户名的话，proxy_user就填写用户名，如root；没有则不填。
       • 代理有密码的话，use_password设置为true，否则false。
       • 以上示例仅为示例说明，具体代理服务器信息，请根据实际情况填写。
    3. 执行如下命令，保存auth.cfg文件并退出。

       :wq

12. 执行以下命令，启动迁移Agent。

    ./startup.sh

13. 请您仔细阅读显示的内容并输入“y”，按“Enter”。

    

14. 根据提示，输入目的端服务器所在华为云账号的AK和SK。

    当出现如下界面时，表示Linux版的SMS-Agent启动成功，开始给主机迁移服务上传源端服务器信息。

    图4 输入AK/SK
    

问题处理

• 如果迁移Agent启动失败，出现"No such file or directory: 'rsync':'rsync'"等错误提示，请您参见安装Linux版的迁移Agent无法正常启动怎么办？。
• 如果迁移Agent启动失败，出现“Failed to start agent! Please check access key and secret key or check if local time matches standard Time!”等错误提示，请您参见如何处理迁移Agent中AK/SK校验失败？。