问题描述

在 Oracle 数据库的安装与维护过程中，常常会遇到各种各样的报错信息，而这些报错往往会阻碍数据库功能的正常使用。本文将针对 “Error in invoking target 'agent nmhs' of makefile” 这一报错，详细阐述其故障处理过程，并深入解释解决方案背后的原理。

适用版本

oracle 11g及以上版本

OEL7.6

一、故障现象

在执行与 Oracle 企业管理器代理（Oracle Enterprise Manager Agent）相关的操作时，系统抛出报错信息：“Error in invoking target 'agent nmhs' of makefile "u01/fapp/oracle/product/11.2/dbhome_1/sysman/lib/ins_emagent.mku01/fapp/oralnventory/logs/installActions2025-05-19 08-30-31PM.10g' for details.”。该报错表明在执行makefile文件中的agent nmhs目标时出现了错误，同时提示可以查看指定日志文件获取更多详细信息。

这意味着 Oracle 企业管理器代理相关组件在构建或配置过程中出现异常，若不及时处理，将影响企业管理器对数据库的监控和管理功能。

二、故障排查

首先，根据报错提示查看日志文件 “u01/fapp/oralnventory/logs/installActions2025-05-19 08-30-31PM.10g”，尝试从中获取更具体的错误原因。

然而，日志文件中可能仅记录了与agent nmhs目标执行相关的部分错误信息，无法直接明确问题根源。

此时，结合以往的经验以及 Oracle 官方文档和社区的相关资料可知，该报错很可能与ins_emagent.mk文件的配置有关，ins_emagent.mk文件在 Oracle 企业管理器代理组件的构建过程中起着关键作用，其中定义了构建所需的各种目标和规则，任何配置不当都可能导致构建失败，进而引发上述报错。

三、解决方案

1）进入相关目录

使用cd $ORACLE_HOME命令进入 Oracle 主目录，再通过cd sysman/lib/进入到包含ins_emagent.mk文件的目录。这一步是为了后续能够准确找到并操作目标文件。

2）备份文件

执行cp ins_emagent.mk ins_emagent.mk.bak命令，对原始的ins_emagent.mk文件进行备份。备份操作至关重要，一旦后续修改出现问题，可以快速恢复到原始状态，避免因错误修改导致更严重的问题，保障系统的安全性和可恢复性。

3）修改文件

使用vi ins_emagent.mk命令打开文件进行编辑，找到$(MK_EMAGENT_NMECTL)相关部分，将其修改为：

[oracle@database ~]$ cd $ORACLE_HOME
[oracle@database dbhome_1]$ cd sysman/lib/

cp ins_emagent.mk ins_emagent.mk.bak

修改文件

vi  ins_emagent.mk 
找到(MK_EMAGENT_NMECTL
修改如下
#===========================
#  emdctl
#===========================

$(SYSMANBIN)emdctl:
        $(MK_EMAGENT_NMECTL) -lnnz11

在修改过程中，务必仔细核对代码内容，确保修改准确无误。修改完成后，保存并退出文件。

4）继续安装

点击安装界面的"retry"继续安装

四、原理分析

ins_emagent.mk文件是 Oracle 企业管理器代理构建过程中的重要配置文件，它定义了一系列用于构建代理组件的规则和目标。在构建emdctl（企业管理器代理守护进程控制工具）时，会依据文件中定义的规则执行相应的操作。

$(MK_EMAGENT_NMECTL)是一个变量引用，它代表着用于构建emdctl的特定命令或命令组合。在未修改之前，该变量对应的配置可能无法正确适配当前的系统环境或 Oracle 版本，导致在执行agent nmhs目标时，构建emdctl的过程失败，从而引发报错。

通过将$(SYSMANBIN)emdctl:对应的执行命令修改为$(MK_EMAGENT_NMECTL) -lnnz11，实际上是为构建emdctl指定了更合适的参数或执行方式。其中-lnnz11参数是针对当前 Oracle 11g 版本和系统环境，用于确保emdctl在构建过程中能够正确链接相关的库文件或遵循特定的构建规则，使得emdctl能够成功构建，进而保证agent nmhs目标能够顺利执行，解决报错问题。

五、验证结果

完成文件修改后，重新执行之前导致报错的操作，检查是否还会出现 “Error in invoking target 'agent nmhs' of makefile” 报错。同时，观察 Oracle 企业管理器代理相关功能是否能够正常使用，例如能否通过企业管理器对数据库进行监控、管理等操作。若不再出现报错且功能正常，则说明故障已成功解决；若问题仍然存在，则需要进一步检查修改是否正确，或者重新排查是否存在其他潜在问题。

#Oracle安装  # agent nmhs