Tuning the acceptor queue size - PingFederate - 11.1

PingFederate Server

bundle
pingfederate-111
ft:publication_title
PingFederate Server
Product_Version_ce
PingFederate 11.1
category
Administrator
Audience
Capability
DeploymentMethod
Product
SingleSignonSSO
Software
SystemAdministrator
pf-111
pingfederate
ContentType_ce

For optimal performance, particularly in larger deployments, PingFederate uses a non-blocking I/O model to process requests. You can tune the acceptor queue size parameters for your environment.

If the request queue reaches its maximum size, additional requests will receive a connection refused error. If this occurs in your environment, you can increase the values of the acceptor queue size parameters pf.admin.acceptQueueSize and pf.runtime.acceptQueueSize. The pf.admin.acceptQueueSize parameter applies to the administrative console and the pf.runtime.acceptQueueSize parameter applies to the engine nodes.

  1. Stop PingFederate.
  2. Open the <pf_install>/pingfederate/bin/run.properties file in an editor.
    Tip:

    Consider making a backup copy of this file.

  3. Go to the following section and change the values of the pf.admin.acceptQueueSize and pf.runtime.acceptQueueSize parameters.
    # HTTP Connector Queue Size Settings
    # ----------------------------------
    # The following properties control the queue size of the HTTP connector.
    #
    # Please refer to the performance tuning guide for further tuning guidance.
    pf.admin.acceptQueueSize=512
    pf.runtime.acceptQueueSize=512
    
  4. Save your changes and restart PingFederate.
  5. For a clustered PingFederate environment, repeat the previous steps on each engine node.