Java 管理扩展连接器属性

可以使用管理控制台、wsadmin 工具、应用程序服务器命令、从命令行界面运行的脚本或您编写的定制 Java™ 管理客户机程序来指定或设置属性。您还可在 soap.client.props 文件中设置 SOAP 连接器属性,在 ipc.client.props 文件中设置 IPC 连接器属性。

Java管理扩展 (JMX) 连接器可以是远程方法调用 (RMI) 连接器、简单对象访问协议 (SOAP) 连接器、JMX 远程应用程序编程接口 (JSR 160) 远程方法调用 (JSR160RMI) 连接器或进程间连接器 (IPC)。

不推荐使用的功能部件 不推荐使用的功能部件: 由于已建议不再支持 RMI 连接器,因此,最终应将所有 RMI 连接器转换为 JSR160RMI 连接器。depfeat

要了解有关如何为 wsadmin 工具、Application Server 命令或脚本编码 JMX 连接器属性的特定信息,请参阅特定工具或命令。阅读应用程序编程接口文档以了解如何编写定制 Java 管理客户机程序的 JMX 连接器属性。

服务器创建的 JMX 连接符使用可在管理控制台中访问的 JMX 连接符属性。wsadmin 工具和 Java 管理客户机使用 soap.client.props、ipc.client.props 和 sas.client.prop 文件中的 JMX 连接器属性。

对于管理控制台,本主题指定了特殊设置或属性的编码。已指定了特定于 JMX 连接器的 soap.client.props 文件和 ipc.client.props 文件中的属性编码。这些 SOAP 属性以 com.ibm.SOAP 开头,而 IPC 属性以 com.ibm.IPC 开头。此处未记录 soap.client.props 文件和 ipc.client.props 文件中的其他属性,这些属性包含可以在应用程序服务器中其他地方设置的信息。com.ibm.ssl.contextProvider 属性的编码(只能在 soap.client.props 文件和 ipc.client.props 文件中设置)也已指定。

[AIX Solaris HP-UX Linux Windows][z/OS]每个概要文件在下列位置具有属性文件:
  • 对于 SOAP 连接器:
    • [Linux][HP-UX][Solaris][AIX][z/OS][IBM i]profile_root/properties/soap.client.props
    • [Windows]profile_root\properties\soap.client.props
  • 对于 IPC 连接器:
    • [Linux][HP-UX][Solaris][AIX][z/OS][IBM i]profile_root/properties/ipc.client.props
    • [Windows]profile_root\properties\ipc.client.props
这些属性文件允许您设置不同的属性,其中包括安全性和超时属性。对于所有在特定概要文件中运行的进程之间使用 SOAP JMX 连接器或 IPC JMX 连接器的管理连接,这些属性是缺省的。例如,在特定概要文件下运行的 wsadmin 程序使用这些文件中的属性值来控制 SOAP 连接器行为和 IPC 连接器行为,除非通过某些其他编程方法覆盖那些属性。

要查看本主题所描述的管理服务定制属性管理控制台页面,请单击服务器 > 服务器类型 > WebSphere 应用程序服务器 > server_name > 管理 > 管理服务 > JMX 连接器 > connector_type > 定制属性

SOAP 连接器属性

此部分讨论与 SOAP 连接器有关的以下 JMX 连接器属性:

配置 URL:

如果要让程序从此文件中读取 SOAP 属性,请指定配置通用资源定位器 (URL) 属性。您可使用下列某个选项设置属性:
  • 从命令行界面运行的脚本。脚本可以将“配置 URL”属性传递给 com.ibm.SOAP.ConfigURL 系统属性上的应用程序服务器。
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 ConfigURL
    数据类型 字符串
    有效值 http://Path/soap.client.props
    缺省值
  • Java 管理客户机。使用 AdminClient.CONNECTOR_SOAP_CONFIG 属性。

安全套接字层 (SSL) 安全性:

使用此属性启用应用程序服务器与 SOAP 客户机之间的 SSL 安全性。通过使用下列其中一个选项来设置此属性:
  • 从命令行界面运行的脚本。
  • soap.client.props 文件。
    信息
    属性 com.ibm.SOAP.securityEnabled
    数据类型 布尔值
    缺省值 False
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 securityEnabled
    数据类型 布尔值
    缺省值 False
  • Java 管理客户机。使用 AdminClient.CONNECTOR_SECURITY_ENABLED 属性。

安全上下文提供程序:

此属性指示要在应用程序服务器与 SOAP 客户机之间使用的安全套接字层 (SSL) 实现。

通过使用 soap.client.props 文件来设置此属性。
信息
属性 com.ibm.ssl.contextProvider
数据类型 字符串
有效值
IBMJSSE2
缺省值 IBMJSSE2

SOAP 请求超时:

选择的值取决于许多因素,例如服务器上安装的应用程序的大小和数目、机器的速度以及机器使用率。

请求超时的程序缺省值为 600 秒。然而,连接到 SOAP 客户机的其他组件可重设缺省值。使用 soap.client.props 文件的组件缺省值为 180 秒

通过使用下列其中一个选项来设置此属性:
  • 从命令行界面运行的脚本。
  • soap.client.props 文件。
    信息
    属性 com.ibm.SOAP.requestTimeout
    数据类型 整数
    范围(以秒计) 0 到 n

    如果属性为零 (0),那么请求从不超时。

    缺省值 180
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 requestTimeout
    数据类型 整数
    范围(以秒计) 0 到 n

    如果属性为零 (0),那么请求从不超时。

    缺省值 600
  • Java 管理客户机。属性为 AdminClient.CONNECTOR_SOAP_REQUEST_TIMEOUT。

SSL 别名:

此属性为 SSL 配置指定用于客户机连接的别名。您可以对别名指定任意的值。

soap.client.props 文件中设置此属性。
信息
属性 com.ibm.ssl.alias
数据类型 字符串
缺省值 DefaultSSLSettings

IPC 连接器属性

此部分讨论与 IPC 连接器有关的以下 JMX 连接器属性:

配置 URL:

如果要让程序从此文件中读取 IPC 属性,请指定配置 URL 属性。您可使用下列某个选项设置属性:
  • 从命令行界面运行的脚本。脚本可以将“配置 URL”属性传递给 com.ibm.IPC.ConfigURL 系统属性上的 Application Server。
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 ConfigURL
    数据类型 字符串
    有效值 http://Path/ipc.client.props
    缺省值
  • Java 管理客户机。使用 AdminClient.CONNECTOR_IPC_CONFIG 属性。

IPC 请求超时:

选择的值取决于许多因素,例如服务器上安装的应用程序的大小和数目、机器的速度以及机器使用率。

请求超时的程序缺省值为 600 秒。然而,连接到 IPC 客户机的其他组件可重设缺省值。使用 ipc.client.props 文件的组件缺省值为 180 秒

通过使用下列其中一个选项来设置此属性:
  • 从命令行界面运行的脚本。
  • ipc.client.props 文件。
    信息
    属性 com.ibm.IPC.requestTimeout
    数据类型 整数
    范围(以秒计) 0 到 n

    如果属性为零 (0),那么请求从不超时。

    缺省值 180
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 requestTimeout
    数据类型 整数
    范围(以秒计) 0 到 n

    如果属性为零 (0),那么请求从不超时。

    缺省值 600
  • Java 管理客户机。属性为 AdminClient.CONNECTOR_IPC_REQUEST_TIMEOUT。

安全套接字层 (SSL) 安全性:

使用此属性启用 Application Server 和 IPC 客户机之间的 SSL 安全性。通过使用下列其中一个选项来设置此属性:
  • 从命令行界面运行的脚本。
  • ipc.client.props 文件。
    信息
    属性 com.ibm.IPC.securityEnabled
    数据类型 布尔值
    缺省值 False
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 securityEnabled
    数据类型 布尔值
    缺省值 False
  • Java 管理客户机。使用 AdminClient.CONNECTOR_SECURITY_ENABLED 属性。

安全上下文提供程序:

此属性指示要在应用程序服务器与 IPC 客户机之间使用的 SSL 实现。

通过使用 ipc.client.props 文件来设置此属性。
信息
属性 com.ibm.ssl.contextProvider
数据类型 字符串
有效值
IBMJSSE2
缺省值 IBMJSSE2

SSL 别名:

此属性为 SSL 配置指定用于客户机连接的别名。 您可以对别名指定任意的值。

ipc.client.props 文件中设置此属性。
信息
属性 com.ibm.ssl.alias
数据类型 字符串
缺省值 DefaultSSLSettings

SOAP、RMI、JSR160RMI 和 IPC 连接器属性

此部分讨论与以下 SOAP 连接器、RMI 连接器、JSR160RMI 连接器和 IPC 连接器有关的 JMX 连接器属性:

连接器类型:

连接器类型为 SOAP、RMI、JSR160RMI 还是 IPC,这取决于应用程序服务器是连接到 SOAP 服务器、RMI 服务器、JSR160RMI 服务器还是 IPC 服务器。您可使用下列某个选项设置属性:
  • wsadmin 工具。
  • 从命令行界面运行的脚本。
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 类型
    数据类型 字符串
    有效值
    SOAPConnector
    RMIConnector
    JSR160RMIConnector
    IPCConnector
    缺省值
    SOAPConnector
    JSR160RMIIPC
  • Java 管理客户机。使用 AdminClient.CONNECTOR_TYPE 属性。使用 AdminClient.CONNECTOR_TYPE_RMI、AdminClient.CONNECTOR_TYPE_SOAP、AdminClient.CONNECTOR_TYPE_JSR160RMI 或 AdminClient.CONNECTOR_TYPE_IPC 常量指定连接器类型。

禁用连接器:

您可以在管理控制台中启用或禁用任何 JMX 连接器。

  • wsadmin 工具。
  • 管理控制台。选中连接器旁边的框以启用此连接器。清除连接器旁边的框以禁用此连接器。
    信息
    属性 已启用
    数据类型 布尔值
    true|false

主机:

应用程序服务器所连接的服务器的主机名或 IP 地址。服务器可以是 SOAP 服务器、RMI 服务器、JSR160RMI 服务器或 IPC 服务器。您可使用下列某个选项设置属性:
  • wsadmin 工具。
  • 从命令行界面运行的脚本。
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 host
    数据类型 字符串
    有效值 主机名或 IP 地址
    缺省值
  • Java 管理客户机。使用 AdminClient.CONNECTOR_HOST 属性。

密码:

应用程序服务器用来访问 SOAP 服务器、RMI 服务器、JSR160RMI 服务器或 IPC 服务器的密码。您可使用下列某个选项设置属性:
  • wsadmin 工具。
  • 从命令行界面运行的脚本。
  • SOAP 服务器、RMI 服务器或 JSR160RMI 服务器的 soap.client.props 文件。
    信息
    属性 com.ibm.SOAP.loginPassword
    数据类型 字符串
    有效值 此值必须与 SOAP、RMI 或 JSR160RMI 的全局 SSL 设置匹配。
    缺省值
  • IPC 服务器的 ipc.client.props 文件。
    信息
    属性 com.ibm.IPC.loginPassword
    数据类型 字符串
    有效值 此值必须与 IPC 的全局 SSL 设置匹配。
    缺省值
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 password
    数据类型 字符串
    有效值 此值必须与 SOAP、RMI、JSR160RMI 或 IPC 的全局 SSL 设置匹配。
    缺省值
  • Java 管理客户机。使用 AdminClient.PASSWORD 属性。

端口:

应用程序服务器连接的服务器的端口号。服务器可以是 SOAP 服务器、RMI 服务器、JSR160RMI 服务器或 IPC 服务器。您可使用下列某个选项设置属性:
  • wsadmin 工具。
  • 从命令行界面运行的脚本。
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 port
    数据类型 整数
    有效值 端口号
    缺省值
  • Java 管理客户机。使用 AdminClient.CONNECTOR_PORT 属性。

用户名:

应用程序服务器在访问 SOAP 服务器、RMI 服务器、JSR160RMI 服务器或 IPC 服务器时使用的用户名。您可使用下列某个选项设置属性:
  • wsadmin 工具。
  • 从命令行界面运行的脚本。
  • SOAP 服务器、RMI 服务器和 JSR160RMI 服务器的 soap.client.props 文件。
    信息
    属性 com.ibm.SOAP.loginUserid
    数据类型 字符串
    有效值 此值必须与 SOAP、RMI 或 JSR160RMI 的全局 SSL 设置匹配。
    缺省值
  • IPC 服务器的 ipc.client.props 文件。
    信息
    属性 com.ibm.IPC.loginUserid
    数据类型 字符串
    有效值 此值必须与 IPC 的全局 SSL 设置匹配。
    缺省值
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 username
    数据类型 字符串
    有效值 此值必须与 SOAP、RMI、JSR160RMI 或 IPC 的全局 SSL 设置匹配。
    缺省值
  • Java 管理客户机。使用 AdminClient.USERNAME 属性。

RMI 连接器属性

此部分讨论与 RMI 连接器有关的以下 JMX 连接器属性:

禁用 JSR 160 RMI 连接器:

缺省情况下对 JMX 远程应用程序编程接口 (JSR 160) 的支持处于启用状态,因此可以自动接收符合规范的 JMX 功能。要禁用特定服务器的功能,请使用下列其中一个选项来设置属性:

  • wsadmin 工具。
  • 管理控制台。在管理控制台的“JMX 连接器定制属性”面板上以“名称/值”对指定属性和值。
    信息
    属性 disableJDKJMXConnector
    数据类型 字符串
    true

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ragt_rconnector_customp
文件名:ragt_rconnector_customp.html