PingFederate Server

Configuring the HTTP connection pool

Optimize connections with external services by adjusting the number and duration of connections.

About this task

PingFederate uses an HTTP connection pool to enable HTTP communication with external systems, including PingOne communication, LDAP gateways, some PingFederate adapters, and many other functions.

Most environments won’t need to tune HTTP connection pool values.

If you find that you need to adjust timeout values, it might indicate issues with your network or overall capacity. You should investigate those configurations before you adjust these settings.

If you do need to tune the HTTP connection pool, you should adjust and test max-connections and max-connections-per-route first.

Adjust max-connections to match the maximum jetty-threads value and max-connections-per-route to match the expected maximum external calls. For example, if you expect to have up to 200 threads using the PingOne API, set max-connections-per-route to 200.

Test and adjust these values as necessary.

Steps

  1. Open the <pf_install>/pingfederate/server/default/data/config-store/http-connection-pooling-manager.xml file.

  2. Adjust the values as detailed in the following table:

    Setting Default Value Description

    max-connections

    350

    The maximum number of connections in the pool.

    max-connections-per-route

    100

    The maximum number of connections per route (port or URL).

    connection-timeout

    60000

    The time in milliseconds available to establish a connection with the remote host.

    request-timeout

    120000

    The time in milliseconds available to retrieve a connection from the connection pool.

    connection-idle-timeout

    30000

    The amount of time a connection in the pool can be idle before it is cleaned up in milliseconds.

    keepalive-timeout

    1000

    The amount of time in milliseconds that a connection can idle before it is returned to the pool for use.

    cleanup-delay-secs

    10

    The delay in seconds before cleaning the HTTP client cache.

  3. Save and close the file.

  4. Restart PingFederate

  5. For a clustered PingFederate environment, replicate the configuration to your other nodes. Learn more in Replicating configurations.