JMX REST 连接器设置
使用 JMX REST 连接器连接到 Liberty 概要文件时,您可以将设置指定为与键值相关的格式。
com.ibm.ws.jmx.connector.client.rest.ConnectorSettings 接口中的这些键为常量,并且每个常量需要采用整数值来指定时间量(以毫秒计)。DISABLE_HOSTNAME_VERIFICATION 常量除外,因为它只接受布尔值。
com.ibm.ws.jmx.connector.client.rest.ConnectorSettings 接口是管理接口。有关管理接口的更多信息,请参阅 Liberty 概要文件的 Java™ API 文档。每个 Liberty 概要文件 API 的 Java API 文档均在信息中心中的编程接口 (API) 部分进行详细说明,而且还可以在 ${wlp.install.dir}/dev 目录的其中一个 javadoc 子目录下的单独 .zip 文件中找到。
- DISABLE_HOSTNAME_VERIFICATION
- 布尔设置,启用时会禁用客户机连接上的主机名验证。在使用的主机名与服务器证书中指定的主机名不匹配的环境中,此设置可能很有用。常量 DISABLE_HOSTNAME_VERIFICATION 的键是字符串 com.ibm.ws.jmx.connector.client.disableURLHostnameVerification。
- MAX_SERVER_WAIT_TIME
- 在 JMX 连接失败而且必须创建新的连接之前,客户机等待服务器变可用的时间量。常量 MAX_SERVER_WAIT_TIME 的键是字符串 com.ibm.ws.jmx.connector.client.rest.maxServerWaitTime。如果复原了连接,那么会重新注册任何先前通知侦听器。要禁用此行为,请将值设置为 zero。
- NOTIFICATION_DELIVERY_INTERVAL
- 在响应来自客户机的通知请求之前,服务器等待新通知的最大时间量。常量 NOTIFICATION_DELIVERY_INTERVAL 的键是字符串 com.ibm.ws.jmx.connector.client.rest.notificationDeliveryInterval。较大的值会产生较出色的通知传送时间,因为建立新连接所花的时间较少。通常,不必调整此值。
- NOTIFICATION_INBOX_EXPIRY
- 在客户机尚未检查新通知,而废弃通知注册之前,服务器等待的时间量。常量 NOTIFICATION_INBOX_EXPIRY 的键是字符串 com.ibm.ws.jmx.connector.client.rest.notificationInboxExpiry。通常,不必调整此值。
- NOTIFICATION_READ_TIMEOUT
- 通知访存的读超时值。因为在响应之前服务器要等待的时间可能长达 NOTIFICATION_DELIVERY_INTERVAL,所以此值必须要大一些,虽然通常不必调整此值。常量 NOTIFICATION_READ_TIMEOUT 的键是字符串 com.ibm.ws.jmx.connector.client.rest.notificationReadTimeout。
- READ_TIMEOUT
- 客户机与服务器之间所有通信的超时值,通知访存除外。如果客户机由连接缓慢或者客户机或服务器进程缓慢,而抛出读超时异常,请调整此值。常量 READ_TIMEOUT 的键是字符串 com.ibm.ws.jmx.connector.client.rest.readTimeout。
- SERVER_STATUS_POLLING_INTERVAL
- MAX_SERVER_WAIT_TIME 值不为零时,在进行服务器再次可用性检查之间客户机等待的时间量。通常,不必调整此值。常量 SERVER_STATUS_POLLING_INTERVAL 的键是字符串 com.ibm.ws.jmx.connector.client.rest.serverStatusPollingInterval。
- CUSTOM_SSLSOCKETFACTORY
- 定制 SSL 套接字工厂,可用于获取套接字。 您可以从自己的密钥库创建自己的 SSL 上下文,然后将该上下文中的套接字工厂与 REST 连接器配合使用。
可以使用系统属性来启用这些 JMX REST 连接器选项。以 MAX_SERVER_WAIT_TIME 选项为例,您可以使用下列其中一个选项:
- 在命令行中,设置系统属性 -Dcom.ibm.ws.jmx.connector.client.rest.maxServerWaitTime=0
- 在 JMX 客户机程序中,添加设置 environment.put("com.ibm.ws.jmx.connector.client.rest.maxServerWaitTime", 0);