Java Management Extensions connector properties
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.
- For the SOAP connector:
- profile_root/properties/soap.client.props
- For the IPC connector:
- profile_root/properties/ipc.client.props
To view the JMX connector custom properties administrative console page that goes with this topic, click
.SOAP connector properties
Configuration URL:
- Scripts run from a command-line interface. Scripts can pass the Configuration URL property to the application server on the com.ibm.SOAP.ConfigURL system property.
- The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property ConfigURL Data type String Valid Value http://Path/soap.client.props Default None - A Java administrative client. Use the AdminClient.CONNECTOR_SOAP_CONFIG property.
Secure Sockets Layer (SSL) security:
- Scripts that run from a command-line interface.
- The soap.client.props file.
Information Value Property com.ibm.SOAP.securityEnabled Data type Boolean Default False - The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property securityEnabled Data type Boolean Default False - A Java administrative client. Use the AdminClient.CONNECTOR_SECURITY_ENABLED property.
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
.
- Scripts that run from a command-line interface.
- The
soap.client.props
file.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 - The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
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 - A Java administrative client. The property is AdminClient.CONNECTOR_SOAP_REQUEST_TIMEOUT.
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.
soap.client.props
file.Information | Value |
---|---|
Property | com.ibm.ssl.alias |
Data type | String |
Default | DefaultSSLSettings |
IPC connector properties
Configuration URL:
- Scripts run from a command-line interface. Scripts can pass the Configuration URL property to the Application Server on the com.ibm.IPC.ConfigURL system property.
- The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property ConfigURL Data type String Valid Value http://Path/ipc.client.props Default None - A Java administrative client. Use the AdminClient.CONNECTOR_IPC_CONFIG property.
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
.
- Scripts that run from a command-line interface.
- The ipc.client.props file.
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 - The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
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 - A Java administrative client. The property is AdminClient.CONNECTOR_IPC_REQUEST_TIMEOUT.
Secure Sockets Layer (SSL) security:
- Scripts that run from a command-line interface.
- The ipc.client.props file.
Information Value Property com.ibm.IPC.securityEnabled Data type Boolean Default False - The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property securityEnabled Data type Boolean Default False - A Java administrative client. Use the AdminClient.CONNECTOR_SECURITY_ENABLED property.
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 |
SOAP, RMI, JSR160RMI, and IPC connector properties
Connector type:
- The wsadmin tool.
- Scripts that run from a command-line interface.
- The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property Type Data type String Valid values SOAPConnector RMIConnector JSR160RMIConnector IPCConnector
Default SOAPConnector JSR160RMI IPC
- A Java administrative client. Use the AdminClient.CONNECTOR_TYPE property. Specify the connector type by using the AdminClient.CONNECTOR_TYPE_RMI, the AdminClient.CONNECTOR_TYPE_SOAP, the AdminClient.CONNECTOR_TYPE_JSR160RMI, or the AdminClient.CONNECTOR_TYPE_IPC constants.
Disabling a connector:
You can enable or disable any of the JMX connectors from the administrative console.
- The wsadmin tool.
- The administrative console. Select the box next to the connector to enable the connector. Clear
the box next to the connector to disable the connector.
Information Value Property enabled Data type Boolean Value true|false
Host:
- The wsadmin tool.
- Scripts that run from a command-line interface.
- The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property host Data type String Valid values Host name or IP address Default None - A Java administrative client. Use the AdminClient.CONNECTOR_HOST property.
Password:
- The wsadmin tool.
- Scripts run from a command-line interface.
- The
soap.client.props
file for the SOAP server, the RMI server, or the JSR160RMI server.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 - The
ipc.client.props
file for the IPC server.Information Value Property com.ibm.IPC.loginPassword Data type String Valid values The value must match the global SSL settings for IPC. Default None - The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
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 - A Java administrative client. Use the AdminClient.PASSWORD property.
Port:
- The wsadmin tool.
- Scripts run from a command-line interface.
- The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property port Data type Integer Valid value Port number Default None - A Java administrative client. Use the AdminClient.CONNECTOR_PORT property.
User name:
- The wsadmin tool.
- Scripts run from a command-line interface.
- The
soap.client.props
file for the SOAP server, an RMI server, a JSR160RMI server.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 - The ipc.client.props file for the IPC server.
Information Value Property com.ibm.IPC.loginUserid Data type String Valid value The value must match the global SSL settings for IPC. Default None - The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
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 - A Java administrative client. Use the AdminClient.USERNAME property.
RMI connector properties
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:
- The wsadmin tool.
- The administrative console. Specify the property and the value as a name-value pair on the JMX
connector custom properties panel of the administrative console.
Information Value Property disableJDKJMXConnector Data type string Value true