You can specify or set a property in the administrative console, the wsadmin tool, Application Server commands, the scripts that run from a command-line interface, or a custom Java administrative client program that you write. You can also set SOAP connector properties in the soap.client.props file and IPC connector properties in the ipc.client.props file.
A Java Management Extensions (JMX) connector can be a Remote Method Invocation (RMI) connector, a Simple Object Access Protocol (SOAP) connector, a JMX Remote application programming interface (JSR 160) Remote Method Invocation (JSR160RMI) connector, or an Inter-Process Communications (IPC) connector.
For specific information on how to code the JMX connector properties for the wsadmin tool, the Application Server commands, or scripts, see the particular tool or command. Read the application programming interfaces documentation to learn how to code the JMX connector properties for a custom Java administrative client program.
The JMX connectors that servers create use JMX connector properties that are accessible in the administrative console. The wsadmin tool and the Java administrative client use JMX connector properties in the soap.client.props, ipc.client.props, and sas.client.prop files.
For the administrative console, this topic specifies the coding of the particular setting or property. Coding of properties in the soap.client.props file and the ipc.client.props file that are specific to JMX connectors is specified. These SOAP properties begin with com.ibm.SOAP and the IPC properties begin with com.ibm.IPC. Other properties in the soap.client.props file and the ipc.client.props file that contain information that can be set elsewhere in the application server are not documented here. The coding for the com.ibm.ssl.contextProvider property, which can be set only in the soap.client.props file and the ipc.client.props file, is specified.
To view the JMX connector custom properties administrative console page that goes with this topic, click
.Configuration URL:
Information | Value |
---|---|
Property | ConfigURL |
Data type | String |
Valid Value | http://Path/soap.client.props |
Default | None |
Secure Sockets Layer (SSL) security:
Information | Value |
---|---|
Property | com.ibm.SOAP.securityEnabled |
Data type | Boolean |
Default | False |
Information | Value |
---|---|
Property | securityEnabled |
Data type | Boolean |
Default | False |
Security context provider:
This property indicates the Secure Sockets Layer (SSL) implementation to use between the application server and the SOAP client.
Information | Value |
---|---|
Property | com.ibm.ssl.contextProvider |
Data type | String |
Valid Values |
|
Default | IBMJSSE2 |
SOAP request timeout:
The value that you choose depends on a number of factors, such as the size and the number of the applications that are installed on the server, the speed of your machine, and the usage of your machine.
The program default value for the request timeout is 600 seconds. However, other components that connect to the SOAP client can override the default. Components that use the soap.client.props file have a default value of 180 seconds.
Information | Value |
---|---|
Property | com.ibm.SOAP.requestTimeout |
Data type | Integer |
Range in seconds | 0 to n If the property is zero (0), the request never times out. |
Default | 180 |
Information | Value |
---|---|
Property | requestTimeout |
Data type | Integer |
Range in seconds | 0 to n If the property is zero (0), the request never times out. |
Default | 600 |
SSL alias:
This property specifies the alias to use for an SSL configuration for client connections. The value of the alias is what you want it to be.
Information | Value |
---|---|
Property | com.ibm.ssl.alias |
Data type | String |
Default | DefaultSSLSettings |
Configuration URL:
Information | Value |
---|---|
Property | ConfigURL |
Data type | String |
Valid Value | http://Path/ipc.client.props |
Default | None |
IPC request timeout:
The value that you choose depends on a number of factors, such as the size and the number of the applications that are installed on the server, the speed of your machine, and the usage of your machine.
The program default value for the request timeout is 600 seconds. However, other components that connect to the IPC client can override the default. Components that use the ipc.client.props file have a default value of 180 seconds.
Information | Value |
---|---|
Property | com.ibm.IPC.requestTimeout |
Data type | Integer |
Range in seconds | 0 to n If the property is zero (0), the request never times out. |
Default | 180 |
Information | Value |
---|---|
Property | requestTimeout |
Data type | Integer |
Range in seconds | 0 to n If the property is zero (0), the request never times out. |
Default | 600 |
Secure Sockets Layer (SSL) security:
Information | Value |
---|---|
Property | com.ibm.IPC.securityEnabled |
Data type | Boolean |
Default | False |
Information | Value |
---|---|
Property | securityEnabled |
Data type | Boolean |
Default | False |
Security context provider:
This property indicates the SSL implementation to use between the application server and the IPC client.
Information | Value |
---|---|
Property | com.ibm.ssl.contextProvider |
Data type | String |
Valid Values |
|
Default | IBMJSSE2 |
SSL alias:
This property specifies the alias to use for an SSL configuration for client connections. The value of the alias is what you want it to be.
Information | Value |
---|---|
Property | com.ibm.ssl.alias |
Data type | String |
Default | DefaultSSLSettings |
Connector type:
Information | Value |
---|---|
Property | Type |
Data type | String |
Valid values |
|
Default |
|
Disabling a connector:
You can enable or disable any of the JMX connectors from the administrative console.
Information | Value |
---|---|
Property | enabled |
Data type | Boolean |
Value | true|false |
Host:
Information | Value |
---|---|
Property | host |
Data type | String |
Valid values | Host name or IP address |
Default | None |
Password:
Information | Value |
---|---|
Property | com.ibm.SOAP.loginPassword |
Data type | String |
Valid values | The value must match the global SSL settings for SOAP, RMI, or JSR160RMI. |
Default | None |
Information | Value |
---|---|
Property | com.ibm.IPC.loginPassword |
Data type | String |
Valid values | The value must match the global SSL settings for IPC. |
Default | None |
Information | Value |
---|---|
Property | password |
Data type | String |
Valid values | The value must match the global SSL settings for SOAP, RMI, JSR160RMI, or IPC. |
Default | None |
Port:
Information | Value |
---|---|
Property | port |
Data type | Integer |
Valid value | Port number |
Default | None |
User name:
Information | Value |
---|---|
Property | com.ibm.SOAP.loginUserid |
Data type | String |
Valid value | The value must match the global SSL settings for SOAP, RMI, or JSR160RMI. |
Default | None |
Information | Value |
---|---|
Property | com.ibm.IPC.loginUserid |
Data type | String |
Valid value | The value must match the global SSL settings for IPC. |
Default | None |
Information | Value |
---|---|
Property | username |
Data type | String |
Valid value | The value must match the global SSL settings for SOAP, RMI, JSR160RMI, or IPC. |
Default | None |
Disabling the JSR 160 RMI connector:
Support for JMX Remote application programming interface (JSR 160) is enabled by default so that you automatically receive specification-compliant JMX function. To disable the function for a particular server, set the property by using one of the following options:
Information | Value |
---|---|
Property | disableJDKJMXConnector |
Data type | string |
Value | true |