A Java Management Extensions (JMX) connector can either be a Remote Method
Invocation (RMI) connector or a Simple Object Access Protocol (SOAP) connector.
Depending on the property, 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.
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. For specific information on how to code the JMX connector
properties for a custom Java administrative client program, see the Java API documentation
for Application Server.
For the administrative console, this topic specifies the coding of the
particular setting or property. Coding of properties in the soap.client.props file
that are specific to JMX connectors is specified. These properties begin with
com.ibm.SOAP. Other properties in the soap.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, is specified.
Each profile has a
property file at installation root/profiles/profile name/properties/soap.client.props.
These property files allows you to set different properties, including security
and timeout properties. These properties are the default for all the administrative
connections that use the SOAP JMX connector between processes that run in
a particular profile. For instance, the wsadmin program running under a particular
profile uses the property values from that file for the SOAP connector behavior
unless the properties are overridden by some other programmatic means.
To 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
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.
Set the property by
using one of the following options:
- Scripts that 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
Specify the configuration Universal
Resource Locator (URL) property if you want a program to read SOAP properties
from this file. You 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. Use the AdminClient.CONNECTOR_SOAP_CONFIG
property.
Security context provider
This property indicates
the Secure Sockets Layer (SSL) implementation to use between the Application
Server and the SOAP client. You can specify either IBM Java Secure Sockets
Extension (IBMJSSE) or
IBM Java Secure Sockets Extension that has undergone Federal Information Processing
Standards certification (IBMJSSEFIPS).
Set
the property by using the
soap.client.props file.
Property |
com.ibm.ssl.contextProvider |
Data type |
String |
Valid Values |
IBMJSSE
IBMJSSEFIPS
IBMJSSE2
|
Default |
IBMJSSE2 |
Secure Sockets Layer (SSL) security
Use
this property to enable SSL security between Application Server and the SOAP
client. Set the property by using one of the following options:
- Scripts that 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. Use the AdminClient.CONNECTOR_SECURITY_ENABLED
property.
SOAP and RMI connector properties
This section discusses
JMX connector properties that pertain to both SOAP connectors and RMI connectors.
Connector
type
A connector type of SOAP or RMI, depends on whether Application
Server connects to a SOAP server or an RMI server. You can set the property
by using one of the following options:
- 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.
Property |
Type |
Data type |
String |
Valid values |
SOAPConnector
RMIConnector
|
Default |
SOAP |
- A Java administrative client. Use the AdminClient.CONNECTOR_TYPE property.
Specify the connector type by using the AdminClient.CONNECTOR_TYPE_RMI or
the AdminClient.CONNECTOR_TYPE_SOAP constants.
Host
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. You can set the property by using one of the following options:
- 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.
Property |
host |
Data type |
String |
Valid values |
Host name or IP address |
Default |
None |
- A Java administrative client. Use the AdminClient.CONNECTOR_HOST property.
Port
The port number of the server to which Application
Server connects. The server can be a SOAP server or an RMI server. You 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. Use the AdminClient.CONNECTOR_PORT property.
User name
The user name that Application Server uses
to access the SOAP server or the RMI server. You 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. Use the AdminClient.USERNAME property.
Password
The password that Application Server uses
to access the SOAP server or the RMI server. You 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. Use the AdminClient.PASSWORD property.