安装Windows版的SMS-Agent

操作场景

您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云账号的AK/SK，迁移Agent启动成功后会收集源端服务器信息并自动发送给主机迁移服务。收集的所有信息仅用于数据迁移，不会用做其他用途。具体收集源端哪些信息可查看主机迁移服务会收集源端的哪些信息？。

Windows版的SMS-Agent安装有两种方式：

• 基于图形界面 Windows Agent(Python3)：Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1
• 基于命令行界面 Windows Agent(Python2)：Windows Server 2008/Windows 7
  

  必须使用Administrator用户登录Windows服务器。

前提条件

• 已获取目的端服务器所在华为云账号的AK/SK。
  • 如果您使用IAM用户进行迁移，具体请参见如何获取AK/SK?（IAM用户）。
  • 如果您直接使用账号进行迁移，具体请参见如何获取AK/SK?（账号）。
• 已获取源端服务器Administrator用户权限。
• 源端服务器的OS类型需要包含在Windows兼容性列表中。
• 源端服务器中未安装杀毒软件，杀毒软件可能会导致Agent启动失败。

  若启动Agent时出现“IO监控启动失败”，请参考启动Agent时出现“IO监控启动失败”，该如何处理。

下载SMS-Agent安装文件

1. 登录主机迁移服务管理控制台。
2. 在左侧导航树中，单击“迁移Agent”，进入“迁移Agent”页面。
3. 在Windows服务器Agent安装区域，单击Windows Agent下载窗格中的“链接”按钮，仔细阅读并同意服务声明后，单击“是”，在弹出的Agent窗口，单击“链接”后的图标，下载Agent安装程序。

   

   • 图形界面（Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1）：请选择“Windows Agent(Python3)”，将“SMS-Agent-Py3.exe”保存到本地。
   • 命令行界面（Windows Server 2008/Windows 7）：请选择“Windows Agent(Python2)”，将“SMS-Agent-Py2.exe”保存到本地。

4. 单击“SHA256链接”后的图标，将包含Hash值的文件保存到本地。对迁移Agent进行软件完整性校验，具体参见如何对迁移Agent进行软件完整性校验？。

   

安装SMS-Agent（Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1）

1. 请将“SMS-Agent-Py3.exe”文件上传至源端服务器。
2. 使用Administrator用户登录源端服务器，双击“SMS-Agent-Py3.exe”文件，进入SMS-Agent安装界面。
3. 单击“安装”，等待安装完成。
4. 单击“完成”，进入SMS-Agent图形界面。
5. 输入目的端服务器所在华为云账号的AK、SK，以及目的端服务器所在区域的SMS域名。SMS域名可在SMS控制台的“迁移Agent”页面获取，如图2所示。
   • 若不使用HTTP/HTTPS代理，请选择：直连。
   • 若使用HTTP/HTTPS代理，请选择：使用代理，并输入代理服务器IP、端口、代理用户名、密码。
     

     • 代理服务器IP：填写代理服务器IP地址，非目的端服务器地址。填写格式为：https://your-proxy-addr.com，其中your-proxy-addr.com需要更换为您代理服务器的地址，协议需要根据代理服务器的实际情况配置，建议您将代理服务器协议配置为https。
     • 端口：填写代理服务器开放的代理端口。
     • 代理用户名：填写代理软件用户名，没有则不填。
     • 密码：填写代理用户名对应的密码，没有则不填。
   图1 启动Agent
   
   图2 获取SMS域名
   

6. 如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤请参见将主机迁移至企业项目最佳实践。
7. 单击“启动”，弹出“注意”窗口。
8. 请您仔细阅读“注意”窗口中的内容，单击“是”。

   当界面显示“启动成功！等待服务端命令...”时，表示Windows版的SMS-Agent启动成功，请访问华为云控制台主机迁移服务界面进行后续操作。

安装SMS-Agent（Windows Server 2008/Windows 7）

1. 请将“SMS-Agent-Py2.exe”文件上传至源端服务器。
2. 使用Administrator用户登录源端服务器，双击“SMS-Agent-Py2.exe”文件，进入SMS-Agent安装界面。
3. 单击“安装”，等待安装完成。
4. 单击“完成”，进入SMS-Agent命令行界面。
   

   若为二次启动，在安装目录下（C:\SMS-Agent-Py2）双击agent-start.exe。

5. 若使用HTTP/HTTPS代理服务器，请执行步骤6。

   若不使用HTTP/HTTPS代理服务器，请执行步骤7。

   

   • 代理服务器为一种特殊网络服务，当您的源端无法通过公网访问华为云时，可以通过代理服务器访问华为云，代理服务器需用户自行配置。
   • 代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。

6. 配置HTTP/HTTPS代理服务器（可选）。

   进入Agent安装目录，如C:\SMS-Agent-Py2\config目录下，修改auth.cfg文件。若迁移过程中不使用HTTP/HTTPS代理，禁止修改auth.cfg文件。

   [proxy-config]
   enable = true
   proxy_addr = https://your-proxy-addr.com
   proxy_port = proxyport
   proxy_user =
   use_password = false

   

   • 使用代理时，enable设置为true。
   • proxy_addr为代理服务器地址，允许源端服务器通过代理服务器访问主机迁移服务，非目的端地址。your-proxy-addr.com需要更换为您代理服务器的地址，协议需要根据代理服务器的实际情况配置，建议您将代理服务器协议配置为https。
   • 代理有用户名的话，proxy_user就填写用户名，如root，没有则不填。
   • 代理有密码的话, use_password设置为true，否则false。

7. 根据命令提示，依次手动输入目的端服务器所在华为云账号的AK、SK，以及目的端服务器所在区域的SMS域名。SMS域名可在SMS控制台的“迁移Agent”页面获取，如图3所示。
   如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤请参见将主机迁移至企业项目最佳实践。

   图3 获取SMS域名
   

   认证通过后，提示SMS-Agent启动，开始给主机迁移服务上传源端服务器信息，界面随即关闭。您可以前往SMS控制台的迁移服务器列表页面查看上报的源端服务器。

问题处理

• 在迁移Agent中输入目的端服务器所在华为云账号的AK/SK以后，若出现“AK，SK鉴权失败”的提示，请您参见如何处理迁移Agent中AK/SK校验失败？。
• 如果控制台看不到源端服务器记录，请参考源端Agent注册后为什么主机迁移服务控制台没有记录，进行排查处理。