This subsection describes the settings for using the functionality for fault tolerance.
Note that the settings for the following functionality need not be specified beforehand.
You implement the J2EE server settings in the Easy Setup definition file. Specify the fault tolerance definition in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file.
The following table describes the definition of the functionality for fault tolerance in the Easy Setup definition file.
Table 3-62 Definition of the functionality for fault tolerance in the Easy Setup definition file
Category | Property | Settings |
---|---|---|
Automatically closing the connections | ejbserver.webj2ee.connectionAutoClose.enabled | Specifies whether the connection will be automatically closed by the Web application. |
Transaction timeout (for J2EE servers)#1 | ejbserver.jta.TransactionManager.defaultTimeOut | Specifies the default timeout value for the transactions running on the J2EE server. |
Transaction recovery | ejbserver.distributedtx.recovery.port | Specifies the fixed port number used for transaction recovery when a global transaction is used. |
Timeout during the checking of unconcluded transactions#2 | ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout | Specifies the timeout value for checking if an in-progress transaction is complete, when the J2EE server is stopped. |
Timeout in error detection | ejbserver.connectionpool.validation.timeout | Specifies the timeout value for the connection error detection functionality and the timeout value for the connection deletion processing by the connection count adjustment functionality. |
#1: In the CMT, you can also specify the settings for the Enterprise Beans, interfaces, and methods. To specify the settings for Enterprise Beans, interfaces, and methods, use the server management commands to specify the settings in the property files when the J2EE applications are set up. For details on the J2EE application settings, see 3.15.12 Definitions in cosminexus.xml.
#2: Set up the timeout during application development. To guarantee transaction reliability during the operations of the J2EE applications, we recommend that you do not set a timeout value.
For details on the Easy Setup Definition file and parameters, see 4.6 Easy Setup Definition file in the uCosminexus Application Server Definition Reference Guide.
Use the server management commands and property files to specify the resource adapter settings in the execution environment. Use the HITACHI Connector Property file to define the functionality for fault tolerance.
The following table describes the definition of the functionality for fault tolerance in the HITACHI Connector Property file.
Table 3-63 Definition of the functionality for fault tolerance in the HITACHI Connector Property file
Items | Specified parameters | Settings |
---|---|---|
Detecting the connection errors | ValidationType and ValidationInterval in the <property> tag | Specifies the time at which the connection errors will be detected and the intervals at which the errors will be detected. Note that to set up a timeout for detecting the connection errors, you enable the usage of the connection management threads with NetworkFailureTimeout. #1 |
Connection management threads | NetworkFailureTimeout in the <property> tag | Specifies whether the connection management threads will be used. When you use the connection management threads, a timeout is set for the connection error detection functionality and the connection count adjustment functionality. The timeout value is fixed at 5 seconds with version 07-60 or earlier. With version 08-00 or later, you can specify any timeout value (default value is 5 seconds). |
Waiting for a connection when connections deplete | RequestQueueEnable in the <property> tag | Specifies whether to enable the waiting for a connection when connections deplete. |
RequestQueueTimeout in the <property> tag | Specifies the waiting time for obtaining a connection. | |
Retrying to obtain a connection | RetryCount in the <property> tag | Specifies the retry count for a failure to obtain a connection. |
RetryInterval in the <property> tag | Specifies the retry interval for a failure to obtain a connection. | |
Connection sweeper | SweeperInterval in the <property> tag#2 | Specifies the interval at which the automatic destruction of connections (connection sweeper) will operate. |
ConnectionTimeout in the <property> tag#2 | Specifies the time from the last use of the connection until the determination of the automatic destruction of the connection. | |
Statement cancellation | CancelStatement in the <property> tag | Specifies whether to enable statement cancellation when a transaction times out. |
#1: You set up the timeout for the connection error detection functionality and the connection count adjustment functionality in the same key. Therefore, when you use a timeout for the connection error detection functionality, a timeout is also used for the connection count adjustment functionality.
#2 If the set value is less than 3600 seconds, KDJE48604-W is output.
For details on the HITACHI Connector Property file, see 4.1 HITACHI Connector Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.
You implement the J2EE application settings in the execution environment with the server management commands and property files. To define the functionality for fault tolerance, use the Session Bean property file, Entity Bean property file, or Message-driven Bean property file.
The tags specified in these property files are mapped in cosminexus.xml. For details on the definitions in cosminexus.xml, see 3.15.12 Definitions in cosminexus.xml.