安装Windows版的SMS-Agent

在进行主机迁移时，如果未在源端服务器部署迁移Agent，将导致无法收集源端服务器信息，进而无法创建迁移任务。您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云账号的AK/SK，迁移Agent启动成功后会收集源端服务器信息并自动发送给主机迁移服务。收集的所有信息仅用于数据迁移，不会用作其他用途。具体收集源端哪些信息可查看主机迁移服务会收集源端的哪些信息？

在进行主机迁移时，SMS-Agent为手动安装并注册。如果源端待迁移的主机数量超过50台，推荐使用迁移中心 MgC服务创建主机批量迁移工作流，通过批量自动注册的方式一次性发起多个迁移任务，从而提高迁移效率并简化操作流程。

不同版本的Windows系统，需要安装的SMS-Agent版本不同，请参考表1，选择相应版本进行安装。

表1 选择SMS-Agent版本
系统版本	SMS-Agent版本	说明
Windows Server 2012、Windows Server 2016、Windows Server 2019、Windows Server 2022、Windows 8.1、Windows 10	基于图形界面 Windows Agent(Python3)	Python2版本支持在高版本的Windows系统上运行。
Windows Server 2008、Windows 7	基于命令行界面 Windows Agent(Python2)	Python2版本支持在高版本的Windows系统上运行。

约束与限制

请使用Administrator用户登录源端Windows服务器进行下载和安装。

前提条件

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

下载SMS-Agent安装文件

登录主机迁移服务管理控制台。
在左侧导航树中，单击“迁移Agent”，进入“迁移Agent”页面。
选择Windows操作系统，根据实际的系统版本，单击对应Windows Agent下载窗格中“链接”后的图标。
- 图形界面（Windows Server 2012/Windows Server 2016/Windows Server 2019/Windows Server 2022/Windows 8.1/Windows 10）：请选择“Windows Agent(Python3)”。
- 命令行界面（Windows Server 2008/Windows 7）：请选择“Windows Agent(Python2)”。
仔细阅读并同意服务声明后，单击“是”，下载Agent安装程序。
分别单击“CMS链接”和“CRL链接”后的图标，将包含CMS文件和CRL文件下载到源端主机。
迁移Agent、CMS文件和CRL文件下载完成后，请对迁移Agent进行软件包完整性校验，具体步骤请参见如何校验迁移Agent软件包数字签名CMS完整性？

安装SMS-Agent

请根据操作系统版本选择对应的安装方式。

Windows Agent(Python3)：Windows Server 2012/Windows Server 2016/Windows Server 2019/Windows Server 2022/Windows 8.1/Windows 10。
Windows Agent(Python2)：Windows Server 2008/Windows 7。

请将“SMS-Agent-Py3.exe”文件上传至源端服务器。
使用Administrator用户登录源端服务器，双击“SMS-Agent-Py3.exe”文件，进入SMS-Agent安装界面。
单击“安装”，等待安装完成。
单击“完成”，进入SMS-Agent图形界面。
输入目的端服务器所在华为云账号的AK、SK，以及SMS域名。SMS域名可在SMS控制台的“迁移Agent”页面获取，如图2所示。

图1 启动Agent

图2 获取SMS域名

选择是否使用HTTP/HTTPS代理服务器进行迁移。

若不使用HTTP/HTTPS代理，请选择“直连”。

若使用HTTP/HTTPS代理，请选择“使用代理”，并输入代理服务器IP、端口、代理用户名和密码等参数，参数说明参见表2。

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

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

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

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

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

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

若不使用HTTP/HTTPS代理服务器，请跳过该步骤，直接执行下一步。

若使用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

参数说明参见下表。

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

根据命令提示，依次手动输入目的端服务器所在华为云账号的AK、SK，以及SMS域名。SMS域名可在SMS控制台的“迁移Agent”页面获取，如图3所示。

如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤请参见将主机迁移至企业项目。
图3 获取SMS域名

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