Tuning the acceptor queue size
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.
About this task
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.
Steps
-
Stop PingFederate.
-
Open the
<pf_install>/pingfederate/bin/run.properties
file in an editor.Consider making a backup copy of this file.
-
Go to the following section and change the values of the
pf.admin.acceptQueueSize
andpf.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
-
Save your changes and restart PingFederate.
-
For a clustered PingFederate environment, repeat the previous steps on each engine node.