JMX 配置

在代理程序中定义 JMX 数据源时，将为您创建部分配置属性。

JMX 运行时配置是唯一的，因为它使您能够对所显示配置量进行一些控制。代理程序的 JMX 客户机可以连接到多种不同类型的应用程序服务器。但是，无需在任一代理程序中支持所有类型的应用程序服务器。您可以确定要支持哪些类型的应用程序服务器，且在代理程序中将不包含不必要的配置节。

在大多数情况下，代理程序设计为监视一种 JMX 应用程序服务器类型。在创建 JMX 数据源，可以使用 JMX Browser。在使用 JMX Browser 时，会自动向代理程序添加用于浏览 MBean Server 的 JMX 服务器配置选项。在创建代理程序之后，要更改可以连接的应用程序服务器类型，请单击“JMX 信息”区域中的全局 JMX 选项。在“JMX 代理程序范围的选项”页面中，更改所需的任何选择。

您可以设计用于监视多种类型的 JMX 应用程序服务器的通用代理程序。在此情况下，可以在“JMX 代理程序范围的选项”页面上选择多个 JMX 服务器配置选项。如果支持多种 JMX 连接类型，那么运行时配置会提示您选择将用于代理程序实例的连接类型。

注：一个代理程序实例只能连接一种 JMX 应用程序服务器。在一个代理程序实例内，子节点可用于连接相同类型的不同 JMX 应用程序服务器。要连接多种 JMX 应用程序服务器，必须为每种 JMX 应用程序服务器类型配置至少一个代理程序实例。

您可以使用 Agent Editor 来查看、添加和更改配置属性。有关指示信息，请参阅使用 Agent Editor 更改配置属性。如果在子节点中定义了 JMX 数据源，那么还能指定“子节点配置覆盖”。有关指示信息，请参阅子节点配置。

如果在代理程序中定义了 JMX 数据源，那么该代理程序必须使用 Java™ 来连接 JMX 应用程序服务器。Java 配置属性将自动添加到该代理程序中。

下列 Java 配置属性特定于代理程序运行时配置：

Java 主目录: 指向 Java 安装目录的标准路径
将代理程序配置为使用的 JVM 与您所监视的应用程序使用的 JVM 相同，对于 WebLogic Server 和 WebSphere® Application Server 尤其应这样配置。
JVM 自变量: 向 Java 虚拟机指定可选自变量列表。
跟踪级别: 定义要写入 Java 跟踪文件的信息量。缺省值为只将错误数据写入日志文件。

注： Agent Builder 不需要这些属性，因为它使用自己的 JVM 以及日志记录，这是通过 JLog 插件配置的。

如果在代理程序中定义 JMX 数据源，那么将向代理程序中自动添加以下必需的公共配置字段：

连接: 与 MBean Server 的连接的类型
用户标识: 用于向 MBean Server 认证的用户标识。
密码: 用户标识的密码。
基本路径: 用于在其中搜索类路径所指定 JAR 文件的目录，或者是 JAR 目录中指定的目录（非标准目录）。在 Windows 上使用分号 (;) 分隔目录名称，在 UNIX 系统上使用分号 (;) 或冒号 (:) 分隔目录名称。
类路径: 代理程序将搜索的显式指定的 JAR 文件。在找到 JAR 文件之前，所有非标准文件都将追加到每个 Base Paths 中。
JAR 目录: 要在其中搜索 JAR 文件的目录。在 Windows 上使用分号 (;) 分隔目录名称，在 UNIX 系统上使用分号 (;) 或冒号 (:) 分隔目录名称。不需要显式标识这些目录中的 JAR 文件；之所以找到这些文件是因为它们确实在其中一个目录中。但不会搜索这些目录的子目录。在找到目录之前，所有非标准目录名都将追加到每个 Base Paths。

注：对于远程监视，这些 JAR 文件及其所有从属 JAR 文件必须以本地方式安装在代理程序运行所在的计算机上。这些 JAR 文件是连接到受监视应用程序所必需的文件。这些 JAR 文件必须在JAR 目录中配置，并且必须位于基本路径和类路径中。此外，以本地方式安装所监视应用程序支持的 JVM，并在 Java 主目录配置字段中指定路径。

示例：

对于 WebLogic 10，类路径为 server/lib/wlclient.jar;server/lib/wljmxclient.jar。基本路径指向 server/lib 目录所在的 WebLogic 应用程序服务器目录。
对于 WebSphere，基本路径指向 WebSphere Application Server 的安装位置。此示例中列出了多个基本路径，为 Windows 和 UNIX 提供了缺省值。类路径列出了相对于基本路径的 JAR 文件。JAR 目录字段的相对值 lib 导致装入基本路径下此目录中的所有 JAR 文件。
- 基本路径：C:\Program Files\IBM\WebSphere\AppServer;/opt/IBM/WebSphere/AppServer
- 类路径：runtimes/com.ibm.ws.admin.client_6.1.0.jar;plugins/com.ibm.ws.security.crypto_6.1.0.jar
- JAR 目录：lib

根据在 JMX Agent-Wide Options 页面中选择的 JMX 服务器类型，将添加以下部分或全部配置属性。缺省值将由 Agent Builder 提供，且可以修改：

特定于 JSR-160 兼容服务器连接的配置属性：

JMX 服务 URL: 要连接以进行监视的 JMX 服务 URL。

特定于 WebSphere Application Server V6.0 及更高版本连接的配置属性：

主机名: 要监视的应用程序服务器所在系统的主机名。对于本地监视，此名称是本地系统名称。对于远程监视，此名称是应用程序服务器所在的系统的主机名。
端口: 在要监视的主机名中使用的端口号。
连接器协议: 监视连接要使用的接口协议。支持 RMI 和 SOAP。
概要文件名称: 用于配置连接的概要文件的名称。

特定于 JBoss Application Server（非 JSR-160）连接的配置属性：

JNDI 名称: 用于查找 MBean Server 的 JNDI 名称。
提供程序 URL: 要连接以进行监视的 JMX 服务提供者 URL。

特定于 WebLogic Server 连接的配置属性：

服务 URL: 要连接以进行监视的 JMX 服务提供者 URL（包含 JNDI 名称）。

注：如果启用了 WebSphere 管理安全，那么必须确保在相应的客户机连接属性文件中禁用客户机登录提示。对于 RMI 连接，要阻止客户机提示用户，必须修改 WebSphere Application Server 概要文件属性目录中 sas.client.props 文件内的 com.ibm.CORBA.loginSource 属性。对于 SOAP 连接，必须修改同一目录中 soap.client.props 文件内的 com.ibm.SOAP.loginSource 属性。在这两种情况下，loginSource 属性都必须设置为不包含值。

您可以使用 Agent Editor 来查看、添加和更改配置属性。请参阅（使用 Agent Editor 更改配置属性）。如果子节点中定义了 Windows 数据源，您还可以指定“子节点配置覆盖”。请参阅子节点配置。