Configuration of the handle pool size

The handle-pool-size stanza entry in the [dsess-cluster] stanza of the WebSEAL configuration file specifies the maximum number of idle Simple Access Object Protocol (SOAP) handles the distributed session client maintains at any given time.

These handles are used for anticipated exchanges with the distributed session cache. Default is 10.

For example:

Default is adequate for most environments.

The value can be increased if communication between WebSEAL and the distributed session cache is slow because all handles are in use. If you decide to modify this value, be aware that each handle reserves a file descriptor on the WebSEAL server. A large value can prevent other WebSEAL functionality that requires file descriptors from working properly.

The maximum value for the handle-pool-size depends on both the platform on which the WebSEAL server is running and various WebSEAL configuration options. In general, do not increase the handle-pool-size beyond 25 handles.

Parent topic: Performance configuration for the distributed session cache