# MgC Agent错误码描述和处理方法 #### MgC Agent错误码 | 错误码 | 描述 | 处理方法 | |:---|:---|:---| | agent_collector_server_netstat_process.0000 | 无法运行于当前操作系统。 | 在Windows系统主机上安装MgC-Agent，重新运行采集器。 | | agent_collector_server_netstat_process.0001 | 缺少必要的参数信息或参数格式有误。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | agent_collector_server_netstat_process.0002 | 无法远程连接目标主机，主机关机、网络或者协议不通等。 | 检查目标主机状态，保证主机开机、相关协议与端口开放后请重试。 | | agent_collector_server_netstat_process.0003 | 无法远程连接目标主机，凭证无法通过认证。 | 检查凭证是否正确，修改正确后请重试。 | | agent_collector_server_netstat_process.0004 | 在Windows主机上创建或设置共享文件夹错误。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | agent_collector_server_netstat_process.0005 | 读取已采集的进程与网络列表的CSV文件失败。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | agent_collector_server_netstat_process.0006 | Windows主机执行进程采集命令后无输出。请检查目标主机是否存在wmic命令。 | 在目标主机上启动wmic服务后请重试。 | | agent_collector_server_netstat_process.0007 | 采集进程运行异常。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | agent_collector_server_netstat_process.0008 | 账号登录被锁定，请稍后再试。 | 稍后请重试，或手动解除账号锁定后请重试。 | | agent_collector_server_netstat_process.0009 | 该IP无法用于与远程节点建立DCOM连接。 | 更换为节点私网IP后重试。 | | agent_collector_server_netstat_process.0011 | 凭证认证失败，服务器拒绝该凭证进行登录。 | 请检查凭证是否正确，以及该账户是否被锁定。如果账号被锁定，您可以通过Get-WinEvent -FilterHashtable @{LogName='Security';Id=4740} -MaxEvents 10 \| Format-List命令查看锁定时间，等待锁定结束后再重启采集任务。或者直接通过net accounts /lockoutthreshold:0命令，禁用账户锁定功能。 | | app-discovery-process-netstat-win.0007 | 全部主机采集异常导致没有输出。 | 输入的全部主机采集异常，需要查看日志具体定位与处理（可能原因：全部连接目标节点异常：关机、无法连通、凭证错误等），请联系技术支持人员或提交工单。 | | app-discovery-process-netstat.0003 | 运行时间duration小于周期interval。 | 设置运行间隔interval小于duration。 | | app-discovery-process-netstat.0004 | 运行周期大于30分钟。 | 请让运行周期小于30分钟。 | | app-discovery-process-netstat.0007 | 未能成功连接到任何节点。 | 输入的全部主机采集异常，需要查看日志具体定位与处理（可能原因：全部连接目标节点异常：关机、无法连通、凭证错误等），请联系技术支持人员或提交工单。 | | app-discovery-process-netstat.0009 | 凭证不合法。 | 凭证错误（不为主机类型或过期），请检查凭证。 | | EDGE.00250063 | 运行脚本异常。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250060 | 执行脚本命令异常。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250062 | 状态文件不存在。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250028 | 读取状态文件异常。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250064 | 状态文件内容为空。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250029 | 任务运行超时。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250055 | 任务重试更新状态失败。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250042 | 查询指定的采集任务实体失败。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250043 | DiscoveryItem或dataSourceConfig为空。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250034 | 解密配置错误。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250035 | 将configString转换为configMap失败。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250036 | 配置项为空。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250026 | 采集器尚未安装。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250032 | 收集器参数错误。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250061 | 收集器配置值错误。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250059 | 命令中的datasourceId与任务中的datasourceId不匹配。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250056 | 任务中没有指定状态的数据源。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250057 | 采集器支持的资源类型为空。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250058 | 资源的ip信息为空。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250065 | 检查远程状态失败。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250066 | 无效的资源类型。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250067 | 创建CSV文件失败。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00250068 | 当前采集器不支持下载采集结果。 | 请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。 | #### Windows主机对应的MgC Agent错误码 | 错误码 | 描述 | 处理方法 | |:---|:---|:---| | EDGE.00000001 | 未知错误 | 导致该错误的原因较多，如网络异常等，请重试该工作流步骤，如果依然无法解决问题，请联系技术支持人员或提交工单。 | | EDGE.00191017 | The 'StartUpAgent' command did not return content in JSON format. | 请关闭源端Windows主机防火墙和杀毒软件，并开启winrm服务（在powershell命令窗口中输入winrm quickconfig开启）。然后重试任务。 | | EDGE.00260001 | 源端IP不可达 | 请确认连接IP是否正确。 | | EDGE.00260002 | 源端winrm服务无法连接 | WinRM服务HTTP通信的默认端口是5985，HTTPS通信的默认端口是5986。 请按以下步骤查询源端主机的WinRM服务状态、监听端口及通信方式。 1. **检查WinRM服务状态** 1. 以管理员身份打开PowerShell。在Windows搜索栏中输入"PowerShell"，右键单击"Windows PowerShell"，选择"以管理员身份运行"。 2. 输入以下命令检查WinRM服务的当前状态。 ``` Get-Service -Name WinRM ``` - 如果输出显示服务状态为"Running"，则表示WinRM服务已启动。 - 如果输出显示服务状态为"Stopped"，则表示WinRM服务未启动。可以使用以下命令启动WinRM服务，按提示输入"y"确认启动WinRM服务。 ``` winrm quickconfig ``` 2. **查询WinRM监听端口及通信方式** 在PowerShell中输入以下命令查看WinRM的配置信息： ``` winrm enumerate winrm/config/listener ``` 该命令会列出所有WinRM监听器的详细信息，包括监听的地址、端口和传输方式（HTTP或HTTPS）等。 3. **配置WinRM使用HTTPS连接（可选）** 如果需要更安全的连接方式，可以配置WinRM使用HTTPS连接。请确保源端服务器上已安装有效的SSL证书。 1. 通过以下命令查看已安装的SSL证书及其指纹： ``` Get-ChildItem -Path Cert:\LocalMachine\My ``` 找到一个有效的SSL证书，记录其指纹（Thumbprint）。 2. 运行以下命令配置WinRM使用HTTPS： ``` New-Item -Path WSMan:\localhost\Listener -Transport HTTPS -Address * -CertificateThumbprint ``` 将\替换为记录的SSL证书指纹。 3. 再次运行以下命令，验证WinRM是否已成功配置为使用HTTPS连接。 ``` winrm enumerate winrm/config/listener ``` | | EDGE.00260003 | 登录失败，原因可能为账号的用户名密码错误、当前账号与连接 IP 不匹配、账号为非管理员账号或未加入管理员组。 | 请仔细核对用户和密码是否正确，并确保它们与iP地址匹配；若使用的账号为非管理员账号，请为其配置管理员权限或直接使用管理员账号。 | | EDGE.00260004 | 凭证权限不足 | 请检查凭证账号是否在管理员用户组。 | | EDGE.00260005 | 源端winrm服务连接失败 | 请检查源端防火墙是否关闭。 | | EDGE.00260006 | 源端发现必要组件缺失 | 请检查源端环境的.Net Framework、wmi、com组件是否损坏。 | | EDGE.00260007 | Edge主机无法信任源端主机 | 请在安装MgC Agent（原Edge）的主机上通过运行以下命令，将远程计算机添加为客户端上的受信任主机： ``` set-item wsman:localhost\\client\\trustedhosts -value * ``` | | EDGE.00260009 | Failed to execute shell job, operation time out in workflow step: StartUpAgent. | 1. 检查迁移中心Agent所在主机与源端主机网络连通性。 在安装MgC Agent的主机，打开命令提示符（cmd），执行如下指令： ``` ping 源端IP ``` - 如果返回响应参数，则执行下一步。 - 如果返回请求超时，请检查IP地址、路由表、中间网络设备ACL或源端防火墙ICMP策略。 2. 检查端口连通性。 成功ping通源端主机后，执行如下命令检查端口（默认端口为5985）： ``` telnet 源端IP 端口 ``` - 命令执行后屏幕无响应（黑屏），表示端口连通。 - 如果提示Could not open connection to the host，检查源端防火墙或安全防护软件设置，确保端口开放。 3. 确保安装迁移中心Agent的主机与源端主机网络和端口均连通后，重试迁移任务。如果仍然失败，请执行下一步进行排查。 4. 检查源端主机C:\\Edge-Scripts路径下是否存在文件"win_startup_executor_v2.ps1"。如果存在，则在源端主机上打开Windows 安全中心，进入"病毒和威胁防护"设置，临时关闭"云提供的保护"，然后在工作流重试迁移任务。如果仍然失败，请执行下一步进行排查。 5. 在本文档中搜索错误码"SMS-Workflow.0404"并根据报错信息选择相应的处理方法。 6. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。 | | EDGE.00260009 | Failed to execute shell job, operation time out in workflow step: SourceEnvCheck. | 1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。 2. 在源端主机的C:\\Edge-Scripts路径下找到脚本文件 "win_env_check_v2.ps1"，使用PowerShell执行该脚本，并根据出现的错误信息在本文档中进行搜索。 3. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。 | | EDGE.00260009 | Failed to execute shell job, operation time out in workflow step: SourceEnvClear. | 1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。 2. 在本文档中搜索错误码"SMS-Workflow.0407"进行处理，并根据报错信息选择相应的处理方法。 3. 处理完成后，在MgC工作流界面进行强制删除。 | | EDGE.00260011 | 目标WinRM连接被拒绝 | 1. 检查迁移中心Agent所在主机与源端主机网络连通性。 在安装MgC Agent的主机，打开命令提示符（cmd），执行如下指令： ``` ping 源端IP ``` - 如果返回响应参数，则执行下一步。 - 如果返回请求超时，请检查IP地址、路由表、中间网络设备ACL或源端防火墙ICMP策略。 2. 检查端口连通性。 成功ping通源端主机后，执行如下命令检查端口（默认端口为5985）： ``` telnet 源端IP 端口 ``` - 命令执行后屏幕无响应（黑屏），表示端口连通。 - 如果提示Could not open connection to the host，检查源端防火墙或安全防护软件设置，确保端口开放。 3. 开启WinRM服务。 确认源端主机防火墙已开放端口后，登录Windows源端主机，以管理员身份运行PowerShell，并执行如下指令，开启WinRM服务。 ``` winrm quickconfig ``` 4. 完成以上步骤后，重试任务。 | #### Linux主机对应的MgC Agent错误码 | 错误码 | 描述 | 处理方法 | |:---|:---|:---| | EDGE.00261001 | 主机IP或端口不可达 | 请检查主机IP或端口是否正确无误，并确保网络连接正常。 | | EDGE.00261002 | 源端端口访问不通过 | 请确认源端端口能否telnet通。 | | EDGE.00261003 | 与源端SSH连接建立失败 | 请根据具体的错误信息进行处理。如无法自行解决，请联系技术支持人员或提交工单。 | | EDGE.00261004 | 用户名和密码错误。 | 请检查MgC Agent （原EDGE）中录入的凭证是否正确。 | | EDGE.00261005 | 源端sftp服务不可用 | 请检查MgC Agent（原Edge）主机能否正常连接到源端sftp服务。 | | EDGE.00261006 | 无法获取源端账号的目录地址 | 请检查源端账号目录地址是否存在。 | | EDGE.00261007 | 执行sudo的tty配置没有关闭 | 该错误出现是因为当源端Linux主机的sudoers文件中启用了requiretty选项时，sudo命令会强制要求使用交互式终端（TTY）。然而，MgC Agent通过SSH执行非交互式脚本命令时，没有分配TTY，因此sudo命令被拒绝并引发错误。请参考以下方法解决： 1. 修改sudoers文件，禁用requiretty。 1. 使用visudo命令编辑sudoers文件（**必须使用visudo以防止语法错误** ）： ``` sudo visudo ``` 2. 找到以下行（可能被注释）： ``` # Defaults requiretty ``` 3. 将其改为以下内容（如果没找到，可以在文件末尾添加一行）： ``` Defaults !requiretty ``` !requiretty表示不强制要求 TTY，允许非交互式环境下使用 sudo。 2. 保存并退出编辑。保存文件后，visudo会自动检查语法。若无错误，配置立即生效。 | | EDGE.00261009 | Command execution timed out in workflow step: SourceEnvCheck. Retry operation if needed. | 1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。 2. 登录源端主机，在/home/user/edge或/root/edge路径下找到脚本"linux_env_check_v2.sh"，使用sh命令执行脚本，并根据出现的错误信息在帮助文档中进行搜索。 3. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。 | | EDGE.00261009 | Command execution timed out in workflow step: StartUpAgent. Retry operation if needed. | 1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。 2. 在本文档中搜索错误码"SMS-Workflow.0404"并根据报错信息选择相应的处理方法。 3. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。 | | EDGE.00261009 | Command execution timed out in workflow step: SourceEnvClear. Retry operation if needed. | 1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。 2. 在本文档中搜索错误码"SMS-Workflow.0407"进行处理，并根据报错信息选择相应的处理方法。 3. 处理完成后，在MgC工作流界面进行强制删除。 |