OpManager代理安装错误及其故障排除

从版本12.5.312及更高版本开始，OpManager支持基于代理的监控，其功能包括获取性能指标并定期将其发送到OpManager。基于代理的监视通过接管性能跟踪和轮询过程的大部分负载来提高服务器效率。

用户在终端计算机上安装或配置代理时可能会遇到问题和错误。此处编译了常见安装错误的列表以及排除每个错误故障的步骤。

内容：

AD GPO 安装中的错误

服务中的错误

安装错误 （InstallOpManagerAgent.log）

agent.log文件中的错误

AD GPO 安装中的错误：

• 如果长时间后仍未安装代理，则需要等待一段时间，直到安装过程开始。由于 GPO 计划程序执行优先级为 7 的安装脚本，因此只有在完成高优先级 Windows 任务后，才会完成此任务。此任务的状态可以在远程终端计算机的任务计划程序中查看，并分配了任务名称。
• 尽管已完成批量安装，但如果代理未在 UI 中的“ITOM 代理 ->代理”页面下列出，请检查并验证是否：
  1. 终端机器中正在运行的代理服务ManageEngine OpManager Agent工作正常。
  2. 检查通信相关案例是否处于正常状态。 （请参阅以下步骤)
  3. 如果上述情况处于正常状态，请尝试在单台计算机上安装代理。如果代理列在“代理”页中，请在所有计算机上批量卸载代理。
  4. 现在重试 AD GPO 安装，并在每台远程计算机上执行安装过程的时间延迟。

服务中的错误：

如果您在启动服务时收到错误弹出窗口，请参阅此列表并按照上述相应步骤操作。

1.“进程意外终止"

这是什么意思？这表示代理已崩溃。

该怎么办？使用此链接在终端计算机上启用调试日志，并重新启动代理服务。您将再次收到相同的终止错误消息。发生这种情况时，在路径“C：\Program Files （x86）\ManageEngine\OpManagerAgent”下压缩整个OpManager代理安装文件夹，并与OpManager支持共享此ZIP。

2. “依赖项服务或组无法启动"

这是什么意思？代理帮助程序存在问题。

该怎么办？请按照以下步骤操作。

• 检查MEAgentHelper.exe是否存在于OpManager Agent安装路径（C：\Program Files（x86）\ManageEngine\OpManagerAgent\bin）的bin文件夹下。如果您没有找到AgentHelper.exe文件，请联系OpManager支持。
• 检查服务是否存在 - 请通过引发的事件在内部检查 Windows 事件查看器中的原因。
  1. 对于解决方法，请通过在CMD终端上执行以下命令来创建名为“ManageEngine Agent Helper”的服务：“
     sc create ”ManageEngine Agent Helper“ binPath=”C：\Program Files （x86）\ManageEngine\OpManagerAgent\bin\MEAgentHelper.exe“ DisplayName=”ManageEngine Agent Helper“ start=auto"

  对于 32 位计算机，请对 binPath 使用以下属性：“C：\Program Files\ManageEngine\OpManagerAgent\bin\MEAgentHelper.exe"

  1. 启动服务。

3.“该产品的另一个版本已经安装"

这是什么意思？终端计算机上已存在代理。

该怎么办？您需要卸载并重新安装代理。如果无法正确重新安装代理，请按照以下步骤从系统中删除代理。

安装错误 （InstallOpManagerAgent.log）

1. 在手动安装代理期间，您可能会收到弹出错误找不到OPMAgentServerInfo.json文件！！使用文件重新安装它“。

您可能还会在 InstallOpManagerAgent.log 文件中找到以下跟踪：“
PostInstallationWrapper ：： ServerInfo Json File 不存在，因此跳过了分析。需要使用OPMAgentServerInfo.json文件重新安装它，或者需要手动更新服务器详细信息。

该怎么办？对于这些错误，只需卸载代理，然后使用从OpManager UI下载的OpManagerAgent.zip文件中提供的OPMAgentServerInfo.json文件重新安装。

2.如果您在错误消息的最后几行中发现错误代码1072，请按照以下步骤操作：

• 关闭注册表编辑器、服务和控制面板等应用程序。
• 使用清理脚本卸载代理（请参阅以下步骤。
• 重试安装过程。

3. 如果在代理安装过程中发现错误 1625：系统策略禁止此安装，可能是由于以下原因：

• 您不是以管理员身份登录的。
• Windows Installer 系统策略阻止你安装经过数字签名的软件更新。

该怎么办？若要解决此错误，请按照此处提到的步骤操作。

agent.log文件中的错误

1. TERMINATE_AGENT

如果在 String = [TERMINATE_AGENT] 中找到日志跟踪状态，则表示用户已尝试使用旧版本的代理文件安装代理。

该怎么办？

• 卸载代理。
• 通过导航到OpManager UI中的以下位置来下载zip文件：Settings>Discovery>Deploy Agent。
• 再次尝试安装过程。

2. RETRY

如果发现日志跟踪为String = [RETRY] 中的状态，则可能是由以下两个问题之一引起的：

• 对于代理的自动升级，OpManager最多允许同时升级50个代理。如果它收到超过 50 个代理的升级启动请求，则代理将面临此错误响应。
  该怎么办？您必须等待更多时间，因为代理的升级队列可能已满。完成一些代理升级后，此升级过程将自动启动。成功升级代理后，数据收集将恢复。
• 如果上一种情况在很长一段时间后仍未得到解决，则可能是注册表中对代理的版本号进行了意外或有意的更改。
  该怎么办？收集启用服务器和代理调试的日志（请参阅此页面）并联系OpManager支持。

3.12175 - SSL 错误

如果在 WinHttpSendRequest -> 12175 中找到日志跟踪为 InternetSendRequestEx： Error，则表示已在终端计算机上禁用 TLS 1.2。您需要启用它并重新启动代理以恢复代理操作。为此，请参阅本文档，并按照相应的步骤操作。

4. WinHttpSendRequest -> 12029 中的错误

以下错误代码说明了无法访问OpManager安装服务器的原因。

• 12007 - 指定的网络不可用。
• 12029 - 无法连接到网络。
• 12002 - 请求超时。

如果发现日志跟踪为InternetSendRequestEx：WinHttpSendRequest -> 12029 中的错误，请执行以下步骤：

• 在终端计算机上打开注册表编辑器。
• 导航到HKEY_LOCAL_MACHINE →软件→Wow6432Node→ ManageEngine → OpManagerAgent -> ServerInfo

对于32位操作系统，请使用路径HKEY_LOCAL_MACHINE →SOFTWARE→ ManageEngine → OpManagerAgent -> ServerInfo

• 检查协议、服务器名称、IP 地址等服务器详细信息是否正确更新。如果没有，请更新详细信息并重新启动代理服务并检查功能是否正常。

5.

对于以下问题，请联系OpManager支持，并在出现提示时共享日志文件以及OpManagerAgent注册表的屏幕截图以供分析。示例图像已显示在页面末尾以供参考。

• 错误代码 - 12004：发生内部错误
• 未经授权的用户
• 参数无效