Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

ConnectionPoolTimeoutException impacts system performance



Multiple ConnectionPoolTimeoutException occurs and system performance degrades.

Error Messages

Caused by: com.pega.apache.commons.httpclient.ConnectionPoolTimeoutException: Timeout waiting for connection
at com.pega.apache.commons.httpclient.MultiThreadedHttpConnectionManager.doGetConnection( 
at com.pega.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getConnectionWithTimeout( 
at com.pega.apache.commons.httpclient.HttpMethodDirector.executeMethod( 
at com.pega.apache.commons.httpclient.HttpClient.executeMethod( 
at com.pega.apache.axis2.transport.http.AbstractHTTPSender.executeMethod( at com.pega.apache.axis2.transport.http.HTTPSender.sendViaPost( 
at com.pega.apache.axis2.transport.http.HTTPSender.send( 
at com.pega.apache.axis2.transport.http.CommonsHTTPTransportSender.writeMessageWithCommons( 
at com.pega.apache.axis2.transport.http.CommonsHTTPTransportSender.invoke( 
at com.pega.apache.axis2.engine.AxisEngine.send( 
at com.pega.apache.axis2.description.OutInAxisOperationClient.send( 
at com.pega.apache.axis2.description.OutInAxisOperationClient.executeImpl( at com.pega.apache.axis2.client.OperationClient.execute(

Steps to Reproduce


Root Cause

A defect or configuration issue in the operating environment.

All the timeout exceptions are related to SOAP Connectors. The following two Dynamic System Settings (DSS) are not configured in the system:
  1. Axis2_Max_HostConnections
  2. Axis2_Max_Connections
These settings apply only to the Connect-SOAP and are managed by Apache HTTP connection pool.


Perform the following local-change:

Configure the below DSS settings.
  1. Axis2_Max_HostConnections
  2. Axis2_Max_Connections
For Pega 7.2.1, apply HFix-29961 (this resolves the issue such that system retrieves the two settings).

Published August 15, 2019 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us