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

当前采集器不支持下载采集结果。

请重试或刷新页面，如果依然无法解决问题，请联系技术支持人员或提交工单。

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 <thumbprint>

      将<thumbprint>替换为记录的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主机无法信任源端主机

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. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。

Failed to execute shell job, operation time out in workflow step: SourceEnvCheck.

1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。
2. 在源端主机的C:\Edge-Scripts路径下找到脚本文件 “win_env_check_v2.ps1”，使用PowerShell执行该脚本，并根据出现的错误信息在本文档中进行搜索。
3. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。

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. 完成以上步骤后，重试任务。

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. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。

Command execution timed out in workflow step: StartUpAgent. Retry operation if needed.

1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。
2. 在本文档中搜索错误码“SMS-Workflow.0404”并根据报错信息选择相应的处理方法。
3. 如果执行完以上步骤依然无法解决，请联系技术人员或提交工单。

Command execution timed out in workflow step: SourceEnvClear. Retry operation if needed.

1. 请尝试重试迁移任务，如果仍然失败，请执行下一步进行排查。
2. 在本文档中搜索错误码“SMS-Workflow.0407”进行处理，并根据报错信息选择相应的处理方法。
3. 处理完成后，在MgC工作流界面进行强制删除。