3

Click here to load reader

824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

Embed Size (px)

Citation preview

Page 1: 824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

8/9/2019 824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

http://slidepdf.com/reader/full/824554-icm-and-sap-web-dispatcher-timeout-parameterpdf 1/3

SAP Note 

Header Data

Symptom 

You want to configure the timeout settings of the Internet Communication Manager (ICM) or the SAPWeb Dispatcher. The SAP Web Application Server may issue HTTP timeout error messages. The errormessage displayed is "500 Connection timed out" if you have not defined your own dynamic ICM errorpages. If the error occurs, you can use the note to help you with troubleshooting.

Other Terms keepalive, 402, 500, ICM_HTTP_TIMEOUT, ICM_HTTP_CONNECTION_FAILED

Reason and Prerequisites 

You are using ICM Release 6.40 or higher for HTTP connections of the SAP NetWeaver ApplicationServer. In other words, your kernel release is 6.40 or higher.Up to and including Release 7.00, ICM is only used in systems that also have an Application ServerABAP (AS ABAP), and not in systems that only have AS Java.

You may also be using the SAP Web Dispatcher.

Solution The note describes the following:

l Client and server roles of the ICM

l List of the various ICM timeout parameters

l Short description of the icm/conn_timeout parameter

l Explanation of "Processing timeout" and "Keepalive timeout"

l Configuration of the ICM parameters for the processing timeout and the keepalive timeout

l Timeout parameters in the SAP Web Dispatcher

l ICM kernel patches that affect timeouts

You can find detailed ICM documentation on the SAP Help Portal (help.sap.com).

Client and server roles of the ICM 

The ICM can forward incoming HTTP connections to the SAP Web Application Server for processing. TheICM then serves as the HTTP server. The ICM can also forward outgoing HTTP connections from the SAPWeb Application Server to other HTTP servers. The ICM then serves as the HTTP client.

Available parameters that control ICM timeouts 

l icm/conn_timeout

l icm/keep_alive_timeout

l icm/server_port_< n >

Parameter icm/conn_timeout 

icm/conn_timeout is used to set the timeout when setting up the connection. If the timeout isexceeded, an error page is generally displayed with the information "404 Resource not found""Partner not reached".

824554 - ICM and SAP Web Dispatcher Timeout Parameter  

Version  22 Validity: 16.08.2012 - active Language  English

Released On  28.08.2012 16:38:24

Release Status  Released for Customer

Component  BC-CST-IC Internet Communication Manager

BC-CST-WDP Web Dispatcher Priority  Recommendations / Additional Info

Category  Help for error analysis

Other Components

Page 2: 824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

8/9/2019 824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

http://slidepdf.com/reader/full/824554-icm-and-sap-web-dispatcher-timeout-parameterpdf 2/3

Therefore, exceeding the icm/conn_timeout does not lead to a "500 Connection timed out" errormessage.

Processing timeout and keepalive timeout 

The parameters icm/keep_alive_timeout and icm/server_port_< n > define the keepalive timeout and theprocessing timeout.ICM distinguishes between these two types of timeout.

l The processing timeout is the timeout between the HTTP request being issued and the HTTPresponse being received.

¡ If the ICM acts as a server for the relevant HTTP request (that is, if it forwards anincoming request to SAP NetWeaver AS), the processing timeout specifies the time that theICM will wait until a response is received from the SAP Web Application Server (AS ABAP orAS Java). This time my be exceeded in the case of long-running applications in AS ABAP or inAS Java (up to 6.40 "J2EE Engine"). If the processing timeout is exceeded, the ICM sends theclient an HTTP response with the error code "500 Connection timed out".

¡ If the ICM serves as a client for the relevant HTTP request (that is, when it forwardsoutgoing requests from the SAP NetWeaver Application Server), the processing timeout statesthe amount time that the ICM waits until a response is received from the network. Thisinterval may also be exceeded in the case of long-running applications in the network.

l The keepalive timeout specifies how long the network should remain open after a request hasbeen processed successfully so that the TCP/IP connection does not have to be reestablishedif additional requests are received.When you set the keepalive timeout, this does not normally lead to timeout errors. You shouldset the keepalive timeout high enough that the connection does not have to be reestablished forrequests that are sent within a short time of each other, but low enough that the number of

unused open TCP/IP connections is not unnecessarily high. Exceeding the Keepalive timeout shouldnever cause an error.

Configuration of the ICM parameters for the processing timeout and the keepalive timeout 

For the ICM, the parameters mentioned here are in the instance profile.

l The processing timeout is set for individual services using the following parameter:icm/server_port_ < n > = ...,PROCTIMEOUT=< s >.

l The keepalive timeout can be set globally for all services of the ICM using the parametericm/keepalive_timeout.You can also set it for individual services by using the following parameter:icm/server_port_ < n > = ...,TIMEOUT=< s >.

If you set this parameter, it overwrites parameter icm/keepalive_timeout for the specifiedservice.

Even if the ICM serves as client for a request, the TIMEOUT and PROCTIMEOUT parameters oficm/server_port_ < n > control the timeouts for the relevant protocol, provided that you have setTIMEOUT or PROCTIMEOUT. However, it is possible for a client to explicitly set the timeout inIF_HTTP_CLIENT, method SEND.

If you have not set the PROCTIMEOUT parameter, TIMEOUT (or icm/keepalive_timeout) defines both theprocessing timeout and the keepalive timeout. In addition, as of release 6.40, the keepalive timeoutis limited to a maximum of 60 seconds.

In a system where the default timeout settings of 60 seconds for the keepalive timeout and theprocessing timeout are insufficient because of long-running applications, we recommend that you setthe TIMEOUT and PROCTIMEOUT parameters for the relevant services so that you can configure themindependent of each other. In addition, we recommend that you do not set the TIMEOUT value higherthan necessary, for example, to the usual default value of 60 seconds.We recommend, for example, the following settings:icm/server_port_0 = PROT=HTTP,PORT=1080,TIMEOUT=60,PROCTIMEOUT=600to allow a maximum processing time of 10 minutes.

Timeout parameter in the SAP Web Dispatcher 

The same timeout parameters are available for the SAP Web Dispatcher as for the ICM. You can changethem in the profile file of the SAP Web Dispatcher (for example, sapwebdisp.pfl). We recommend thatyou set the same parameters in the SAP Web Dispatcher and ICM.

Known errors in ICM and Web Dispatcher timeout handling 

l Since 6.40 patch level 64, there have not been any known errors in ICM and Web Dispatchertimeout handling.

l In Release 7.00 and later releases, there are no known errors in ICM and Web Dispatcher TimeoutHandling.

Known Internet Explorer errors in the keepalive timeout handling 

Known errors in the keepalive handling from Internet Explorer are described in Note 900804. However,these errors are not usually displayed as timeout errors.

Validity

Page 3: 824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

8/9/2019 824554 - ICM and SAP Web Dispatcher Timeout Parameter.pdf

http://slidepdf.com/reader/full/824554-icm-and-sap-web-dispatcher-timeout-parameterpdf 3/3

 

This document is not restricted to a software component or software component version

References

This document refers to:

SAP Notes 

This document is referenced by:

SAP Notes (17) 

1488594 PI CTC: Connection to system Integration Builder lost 

1432150 XI runtime: HTTP return code 110 

1352731 MOpz: Download or deployment hangs when using SLM 1347276 IC_AGENT Business Role:Pre-mature closure of IE 

1162605 Network performance for CRM (IC) Webclient 

1139406 CTS+: cx_ai_system_fault during import of orders 

1004684  Abort of large content import and transport 

981211 HTTP debugging with the new debugger is terminated 

921061 How to set Timeouts in Mobile Infrastructure 

906435 XI Internal HTTP Error during CALL_ADAPTER 

893272 Export to MS Excel or CSV from Web is incomplete 

888362 Helpful technical hints for installing and maintaining MIC 

834077 rdisp/plugin_auto_logout overrides ICF timeout 

737625 Parameter recommendations for the ICM 

698017 ICM Patch Collection (6.40) 

634006 Note on the preclarification of ICM messages 633539 Time-out problems in the IC WebClient 

893272 Export to MS Excel or CSV from Web is incomplete 

1488594 PI CTC: Connection to system Integration Builder lost 

906435 XI Internal HTTP Error during CALL_ADAPTER 

1352731 MOpz: Download or deployment hangs when using SLM 

834077 rdisp/plugin_auto_logout overrides ICF timeout 

1432150 XI runtime: HTTP return code 110 

921061 How to set Timeouts in Mobile Infrastructure 

1811778 TIMEOUT of server port does not override global parameter icm/keep_alive_timeout 

1162605 Network performance for CRM (IC) Webclient 

737625 Parameter recommendations for the ICM 

1004684  Abort of large content import and transport 

888362 Helpful technical hints for installing and maintaining MIC 

981211 HTTP debugging with the new debugger is terminated 

633539 Time-out problems in the IC WebClient 

1347276 IC_AGENT Business Role:Pre-mature closure of IE 

1139406 CTS+: cx_ai_system_fault during import of orders 

634006 Note on the preclarification of ICM messages