# 安装Windows版的SMS-Agent 在进行主机迁移时，如果未在源端服务器部署迁移Agent，将导致无法收集源端服务器信息，进而无法创建迁移任务。您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云账号的AK/SK，迁移Agent启动成功后会收集源端服务器信息并自动发送给主机迁移服务。收集的所有信息仅用于数据迁移，不会用作其他用途。具体收集源端哪些信息可查看[主机迁移服务会收集源端的哪些信息？](https://support.huaweicloud.com/sms_faq/sms_faq_0002.html) ![](https://support.huaweicloud.com/usermanual-sms/public_sys-resources/note_3.0-zh-cn.png) 在进行主机迁移时，SMS-Agent为手动安装并注册。如果源端待迁移的主机数量超过50台，推荐使用迁移中心 MgC服务[创建主机批量迁移工作流](https://support.huaweicloud.com/usermanual-mgc/mgc_03_3192.html)，通过批量自动注册的方式一次性发起多个迁移任务，从而提高迁移效率并简化操作流程。 不同版本的Windows系统，需要安装的SMS-Agent版本不同，请参考[表1]，选择相应版本进行安装。 表1选择SMS-Agent版本 | 系统版本 | SMS-Agent版本 | 说明 | |:---|:---|:---| | Windows Server 2012、Windows Server 2016、Windows Server 2019、Windows Server 2022、Windows Server 2025、Windows 8.1、Windows 10、Windows 11 | 基于图形界面 Windows Agent(Python3) | Python2版本支持在高版本的Windows系统上运行。 | | Windows Server 2008、Windows 7 | 基于命令行界面 Windows Agent(Python2) | Python2版本支持在高版本的Windows系统上运行。 | #### 约束与限制 请使用Administrator用户登录源端Windows服务器进行下载和安装。 #### 前提条件 - 已获取目的端服务器所在华为云账号的AK/SK。 - 如果您使用IAM用户进行迁移，具体请参见[如何获取AK/SK?（IAM用户）](https://support.huaweicloud.com/sms_faq/sms_faq_0012.html)。 - 如果您直接使用账号进行迁移，具体请参见[如何获取AK/SK?（账号）](https://support.huaweicloud.com/sms_faq/sms_faq_0032.html)。 - 已获取源端服务器Administrator用户权限。 - 源端服务器的OS类型需要包含在[Windows兼容性列表](https://support.huaweicloud.com/productdesc-sms/sms3_01_0011.html)中。 - 源端服务器中未安装杀毒软件，杀毒软件可能会导致Agent启动失败。 #### 下载SMS-Agent安装文件 1. 登录[主机迁移服务管理控制台](https://console.huaweicloud.com/sms3.0/?#/sms/overview)。 2. 在左侧导航树中，单击"迁移Agent"，进入"迁移Agent"页面。 3. 选择**Windows** 操作系统，根据实际的系统版本，单击对应Windows Agent下载窗格中"链接"后的![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001942907782.png)图标。 - 图形界面（Windows Server 2012/Windows Server 2016/Windows Server 2019/Windows Server 2022/Windows Server 2025/Windows 8.1/Windows 10/Windows 11）：请选择"Windows Agent(Python3)"。 - 命令行界面（Windows Server 2008/Windows 7）：请选择"Windows Agent(Python2)"。 ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000002518166723.png "点击放大") 4. 仔细阅读并同意服务声明后，单击"是"，下载Agent安装程序。 5. 分别单击"CMS链接"和"CRL链接"后的![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001875505132.png)图标，将包含CMS文件和CRL文件下载到源端主机。 ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000002485929802.png "点击放大") 6. 迁移Agent、CMS文件和CRL文件下载完成后，请对迁移Agent进行软件包完整性校验，具体步骤请参见[如何校验迁移Agent软件包数字签名CMS完整性？](https://support.huaweicloud.com/sms_faq/sms_faq_0037.html) #### 安装SMS-Agent 请根据操作系统版本选择对应的安装方式。 - Windows Agent(Python3)：Windows Server 2012/Windows Server 2016/Windows Server 2019/Windows Server 2022/Windows Server 2025/Windows 8.1/Windows 10/Windows 11。 - Windows Agent(Python2)：Windows Server 2008/Windows 7。 - [安装Windows Agent(Python3)] - [安装Windows Agent(Python2)] 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]所示。 图1启动Agent ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000001208540699.png "点击放大") 图2获取SMS域名 ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000002518175171.png "点击放大") 6. 选择是否使用HTTP/HTTPS代理服务器进行迁移。 - 若不使用HTTP/HTTPS代理，请选择"直连"。 - 若使用HTTP/HTTPS代理，请选择"使用代理"，并输入代理服务器IP、端口、代理用户名和密码等参数，参数说明参见[表2]。 表2代理参数配置说明 | 参数 | 说明 | |:---|:---| | 代理服务器IP | 填写代理服务器IP地址，非目的端服务器地址。填写格式为：https://your-proxy-addr.com，其中your-proxy-addr.com需要更换为您代理服务器的地址，协议需要根据代理服务器的实际情况配置，建议您将代理服务器协议配置为https。 | | 端口 | 填写代理服务器开放的代理端口。 | | 代理用户名 | 填写代理软件用户名，没有则不填。 | | 密码 | 填写代理用户名对应的密码，没有则不填。 | 7. 如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤，请参见[将主机迁移至企业项目](https://support.huaweicloud.com/bestpractice-sms/sms_05_0004.html)。 8. 单击"启动"，弹出"注意"窗口。 9. 请您仔细阅读"注意"窗口中的内容，单击"是"。 当界面显示"**启动成功！等待服务端命令...**"时，表示Windows版的SMS-Agent启动成功，请访问华为云控制台主机迁移服务界面进行后续操作。 1. 请将"**SMS-Agent-Py2.exe**"文件上传至源端服务器。 2. 使用Administrator用户登录源端服务器，双击"**SMS-Agent-Py2.exe**"文件，进入SMS-Agent安装界面。 3. 单击"安装"，等待安装完成。 4. 单击"完成"，进入SMS-Agent命令行界面。 ![](https://support.huaweicloud.com/usermanual-sms/public_sys-resources/note_3.0-zh-cn.png) 若为二次启动，在安装目录下（C:\\SMS-Agent-Py2）双击agent-start.exe。 5. 选择是否使用HTTP/HTTPS代理服务器进行迁移。代理服务器为一种特殊网络服务，当您的源端无法通过公网访问华为云时，可以通过代理服务器访问华为云，代理服务器需用户自行配置。代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。 - 若不使用HTTP/HTTPS代理服务器，请跳过该步骤，直接执行[下一步]。 - 若使用HTTP/HTTPS代理服务器，请执行以下步骤： 1. 进入Agent安装目录，如C:\\SMS-Agent-Py2\\config目录下。 2. 修改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。 | 6. 根据命令提示，依次手动输入目的端服务器所在华为云账号的AK、SK，以及SMS域名。SMS域名可在SMS控制台的"迁移Agent"页面获取，如[图3]所示。 如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤请参见[将主机迁移至企业项目](https://support.huaweicloud.com/bestpractice-sms/sms_05_0004.html)。 图3获取SMS域名 ![](https://support.huaweicloud.com/usermanual-sms/zh-cn_image_0000002518296039.png "点击放大") 认证通过后，提示SMS-Agent启动，开始给主机迁移服务上传源端服务器信息，界面随即关闭。您可以前往SMS控制台的"服务器迁移"列表页面查看上报的源端服务器。 #### 问题处理 - 在迁移Agent中输入目的端服务器所在华为云账号的AK/SK以后，若出现"AK，SK鉴权失败"的提示，请参考[SMS.0202 AK,SK鉴权失败](https://support.huaweicloud.com/sms_faq/sms_faq_0024.html)进行处理。 - 如果启动Agent时出现"SMS.1902 "的错误码报错，请参考[SMS.1902 IO监控启动失败](https://support.huaweicloud.com/sms_faq/sms_faq_0026.html)进行处理。 - 如果控制台看不到源端服务器记录，请参考[源端Agent注册后为什么主机迁移服务控制台没有记录](https://support.huaweicloud.com/sms_faq/sms_faq_0003.html)，进行排查处理。 #### 卸载SMS-Agent 迁移完成后，您可以卸载源端安装的SMS-Agent，具体卸载方法请参考[卸载Windows版SMS-Agent](https://support.huaweicloud.com/sms_faq/sms_faq_0035.html#section0)。