Hitachi

uCosminexus Application Server Compatibility Guide


5.6.5 Setting the communication timeout when sending and receiving a request (When the Smart Composer functionality is not used)

You set the communication timeout for sending and receiving requests between the client and the Web server and between the redirector and the Web container.

The following are the methods for setting the communication timeout in each of the cases:

Organization of this subsection

(1) Settings in the Web server for receiving requests

In the Web server, you specify the communication timeout for receiving the requests from the client in the Web server. You can use either Cosminexus HTTP Server or Microsoft IIS as the Web server.

(a) How to set

Set the communication timeout for the process of receiving requests forwarded from the client in the following files:

  • httpsd.conf (In Cosminexus HTTP Server)

    In the Timeout directive, set the waiting time (seconds) for the process of receiving requests from the client. The default value of the Timeout directive is 300 seconds. Note that the value set here is shared with the communication timeout for the process of sending data to the client. For details on the communication timeout for the process of sending data to the client, see 5.6.6(3) Settings in the Web server for sending responses.

  • isapi_redirect.conf (In Microsoft IIS)

    Set the waiting time (seconds) for the process of receiving requests from the client in the receive_client_timeout key.

(b) Precautions for setup

To set the timeout for receiving requests in the Web server, take into consideration the network configuration and traffic status between the client and the Web server and specify a time in which the occurrence of failure can be determined.

(2) Settings in the redirector for sending requests

When sending a request from the redirector to the Web container, first establish a connection with the Web container. You can set the communication timeout for sending requests from the redirector to the Web container when the connection is established and when the request is sent. You can also set the retry frequency to be used when an attempt to establish connection and to send the request header fails.

(a) How to set

Specify the communication timeout for establishing the connection and the request sending process and the retry frequency from the redirector in the following files:

  • mod_jk.conf (In Cosminexus HTTP Server)

    • Communication timeout in establishing connection

      Set the waiting time (seconds) for the process of establishing a connection with the Web Container in the JkConnectTimeout key. The default value of the JkConnectTimeout key is 30 seconds.

    • Timeout for the request sending process

      Set the waiting time (seconds) for the process of sending a request to the Web container in the JkSendTimeout key. The default value of the JkSendTimeout key is 100 seconds.

    • Retry frequency for establishing a connection and sending a request

      Set the retry frequency for establishing a connection and sending a request to the Web container in the JkRequestRetryCount key. The default value of the JkRequestRetryCount key is three times.

  • isapi_redirect.conf (In Microsoft IIS)

    • Communication timeout in connection process

      Set the waiting time (seconds) for the process of establishing a connection with the Web container in the connect_timeout key. The default value of the connect_timeout key is 30 seconds.

    • Timeout for the request sending process

      Set the waiting time (seconds) for the process of sending a request to the Web container in the send_timeout key. The default value of the send_timeout key is 100 seconds.

    • Retry frequency for establishing a connection and sending a request

      Set the retry frequency for establishing a connection and sending a request to the Web container in the request_retry_count key. The default value of the request_retry_count key is three times.

(b) Precautions for setup

Take the followings into the consideration when you specify the communication timeout value for sending requests and the retry frequency set in the redirector:

  • The retry frequency includes the first connection established and the first request sent. Therefore, if the first connection or request sending process fails, the retrying of connection or request sending process is counted as the second time.

  • If you specify 0 as the communication timeout for establishing a connection and for the request sending process or if you set a longer time than the re-send timer for establishing a connection and sending data by TCP, the TCP timeout value is applied to communication timeout value.

(3) Settings in the Web container for receiving requests

Set the communication timeout when the Web container receives a request from the redirector, to the Web container.

(a) How to set

Set the communication timeout for the process of receiving requests forwarded from the redirector in the following file:

  • usrconf.properties

    Set the waiting time (seconds) for the process of receiving requests from the redirector in the webserver.connector.ajp13.receive_timeout key.

(b) Precautions for setup

Take the followings into consideration when you specify the timeout value set in the Web container for receiving requests:

  • Set a value bigger than the time set in the timeout for receiving Web server requests.

    If a value smaller than the time specified as the timeout for receiving Web server requests is set, and network failure occurs in the client and between the client and Web server, the timeout occurs in the Web container before the Web server. In this case, you cannot determine whether the failure has occurred in the Web server or in the client.

  • If data needs to be received from the client, set the time in which data can be received taking into consideration the communication speed with the client.

  • When failure occurs in the redirector while the data is being sent to the Web Container, the failure is detected by the timeout in the TCP re-send timer.

    Note that in UNIX, the time until timeout depends on the OS.