Java Management Extensions connector properties

 

+

Search Tips   |   Advanced Search

 

You can specify or set a property using...

• console
• wsadmin tool
• Application Server commands
• Scripts that run from a command-line interface
• Custom Java administrative client program that you write
• soap.client.props

A JMX connector can be either...

• Remote Method Invocation (RMI) connector
• Simple Object Access Protocol (SOAP) 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. 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 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 property...

com.ibm.ssl.contextProvider

...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 console panel that goes with this article, click...

Servers | Application servers | server name | Server Infrastructure | Administration | Administration Services | Additional properties | JMX Connectors| connector type | Additional Properties | Custom properties

 

SOAP connector properties

 

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 console. Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the 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 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 console. Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the 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

Indicates the SSL implementation to use between the Application Server and the SOAP client. Set the property by using the soap.client.props file.

Property:	com.ibm.ssl.contextProvider
Data type:	String
Valid Values	IBMJSSE2
Default:	IBMJSSE2

 

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 console.

  Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the console.

  Property:	securityEnabled
  Data type:	Boolean
  Default:	False

• A Java administrative client.

  Use the AdminClient.CONNECTOR_SECURITY_ENABLED property.

 

SOAP and RMI connector properties

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 console. Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the console.

  Property:	Type
  Data type:	String
  Valid values:	SOAPConnector RMIConnector
  Default:	SOAPConnector

• A Java administrative client.

  Use the property...

  AdminClient.CONNECTOR_TYPE

  Specify the connector type by using one of the constants...

  • AdminClient.CONNECTOR_TYPE_RMI
  • AdminClient.CONNECTOR_TYPE_SOAP

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 console.

  Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the 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 console.

  Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the 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 console.

  Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the 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 console.

  Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the 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.

 

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 console. Specify the property and the value as a name-value pair on the JMX connector custom properties panel of the console.

  Property:	disableJDKJMXConnector
  Data type:	string
  Value:	true

---

 

Related tasks

Set up the administrative architecture
Configure security with scripting

 

Related Reference

Java Management Extensions connectors
Administrative properties for scripting

 

Reference topic