文档首页/ 主机迁移服务 SMS/ 常见问题/ Agent安装与启动/ 源端Windows主机启动SMS-Agent报错:DLL Load failed
更新时间:2025-07-25 GMT+08:00
分享

源端Windows主机启动SMS-Agent报错:DLL Load failed

问题描述

源端Windows主机启动SMS-Agent.exe程序时,无法正常启动,弹出错误提示框。错误信息关键内容为:Failed to execute script 'pyi_rth_pkgres' due to unhandled exception: DLL load failed while importing pyexpat。

问题分析

SMS-Agent.exe是一个通过Python语言打包的应用程序,其运行依赖于主机本地系统的特定组件。出现此错误的核心原因是,您在源端主机安装的Python 3版本SMS-Agent程序在启动时无法找到其功能所必需的一个底层动态链接库(DLL)文件。

解决方案

使用兼容性更好的Python 2版本的SMS-Agent进行迁移。
  1. 登录主机迁移服务管理控制台,在“迁移Agent”页面,选择Windows系统,将“Windows Agent(Python2)”版本的安装程序下载到源端服务器。
  2. 使用Administrator用户登录源端服务器,双击运行下载的 SMS-Agent-Py2.exe 文件。
  3. 在弹出的安装向导中,单击“安装”,等待安装完成,然后单击“完成”。 程序文件会自动解压到安装目录(默认为 C:\SMS-Agent-Py2)。
  4. 进入SMS-Agent的安装目录C:\SMS-Agent-Py2,在目录中找到并双击运行“agent-start.exe”
  5. 弹出一个命令行窗口,根据提示依次输入目的端服务器所在华为云账号的AK、SK,以及SMS域名。即可成功启动Agent。

相关文档