Java Management Extensions connector properties
A JMX connector can either be an RMI connector or a SOAP connector.
Each profile has a property file at...
WAS_HOME/profiles/profilename/properties/soap.client.propsTo view the JMX connector custom properties administrative console panel that goes with this article, click one of the following paths:
- Servers | Application servers | server name | Server Infrastructure | Administration | Administration Services | Additional properties | JMX Connectors| connector type | Additional Properties | Custom properties
- System administration | Deployment manager | Additional Properties | Administration Services | Additional Properties | JMX Connectors| connector type| Additional Properties | Custom properties
- System administration | Node agents | node agent name | Additional Properties | Administration Services | Additional Properties | JMX Connectors| connector type| Additional Properties | Custom properties
SOAP connector properties
This section discusses JMX connector properties that pertain to SOAP connectors.
SOAP Request timeout
Specifies the SOAP client 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 level of 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.
We can set the property by using one of the following options:
- Scripts run from a command line interface.
- The soap.client.props file.
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.
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.
Configuration URL
Specifies the URL of the soap.client.props file. Used if you want a program to read SOAP properties from the file. We can set the property by using one of the following options:
- 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.
Property ConfigURL Data type String Valid Value http://Path/soap.client.props Default None - A Java administrative client. The property is AdminClient.CONNECTOR_SOAP_CONFIG.
Security context provider
Specifies the SSL implementation to use between the Application Server and the SOAP client. We can specify either IBM JSSE (IBMJSSE) or IBM JSSE that has undergone FIPS certification (IBMJSSEFIPS).
We can set the property by using the soap.client.props file.
Property com.ibm.ssl.contextProvider Data type String Valid Values IBMJSSE IBMJSSEFIPS IBMJSSE2Default IBMJSSE2
SSL security
Use this property to enable SSL security between Application Server and the SOAP client. We can set the property by using one of the following options:
- Scripts run from a command line interface.
- The soap.client.props file.
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.
Property securityEnabled Data type Boolean Default False - A Java administrative client. The property is AdminClient.CONNECTOR_SECURITY_ENABLED.
SOAP and RMI connector properties
This section discusses JMX connector properties that pertain to both SOAP connectors and RMI connectors.
Connector type
Specify a connector type of SOAP or RMI, depending on whether Application Server connects to a SOAP server or an RMI server. We can set the property by using one of the following options:
- 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.
Property Type Data type String Valid values SOAPConnector RMIConnectorDefault SOAP - A Java administrative client. The property is AdminClient.CONNECTOR_TYPE. Specify by using the AdminClient.CONNECTOR_TYPE_RMI or the AdminClient.CONNECTOR_TYPE_SOAP constants.
Host
Use the host property to specify the host name or the IP address of the server to which Application Server connects. The server can be a SOAP server or an RMI server. We can set the property by using one of the following options:
- 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.
Property host Data type String Valid values Host name or IP address Default None - A Java administrative client. The property is AdminClient.CONNECTOR_HOST.
Port
Use the port property to specify the port number of the server to which Application Server connects. The server can be a SOAP server or an RMI server. We can set the property by using one of the following options:
- 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.
Property port Data type Integer Valid value Port number Default None - A Java administrative client. The property is AdminClient.CONNECTOR_PORT.
User name
Specifies the user name that Application Server uses to access the SOAP server or the RMI server. We can set the property by using one of the following options:
- The wsadmin tool.
- Scripts run from a command line interface.
- The soap.client.props file.
Property com.ibm.SOAP.loginUserid Data type String Valid value The value must match the global SSL settings for SOAP or RMI. 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.
Property username Data type String Valid value The value must match the global SSL settings for SOAP or RMI. Default None - A Java administrative client. The property is AdminClient.USERNAME.
Password
Specifies the password that Application Server uses to access the SOAP server or the RMI server. We can set the property by using one of the following options:
- The wsadmin tool.
- Scripts run from a command line interface.
- The soap.client.props file.
Property com.ibm.SOAP.loginPassword Data type String Valid values The value must match the global SSL settings for SOAP or RMI. 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.
Property password Data type String Valid values The value must match the global SSL settings for SOAP or RMI. Default None - A Java administrative client. The property is AdminClient.PASSWORD.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.