LDAP Directory: Connection Pooling (SAP Library

LDAP Directory: Connection Pooling

Connection pooling improves the performance of requests to the LDAP directory servers. It is a technique used for sharing server resources among requesting clients. Without connection pooling, each request to the LDAP directories causes a new connection to the directory server to be created and then released when the connection is no longer required. The overhead in creating and releasing these connections has adverse effects on performance. With connection pooling, connections are stored in pools after they have been established and are reused for subsequent requests.

A connection can have the following statuses:

· open: either in use or idle

· in use: open connection currently in use

· idle: open connection available for reuse

· closed: no longer available for use

The following diagram illustrates which actions are possible on connections:

This graphic is explained in the accompanying text

Connection Pooling Properties

Property	Value	Description
ume.ldap.connection_pool. max_connection_usage_time_ check_interval	Default value is 120,000	Interval in milliseconds between checks for outdated connections in the connection pool.
ume.ldap.connection_pool. max_idle_connections	Default value is 5.	Maximum number of idle connections in the connection pool. If the maximum number of idle connections is reached, the connection pool will close every incoming released connection.
ume.ldap.connection_pool. max_idle_time	Default value is 300,000.	Maximum time in milliseconds for an idle connection in the connection pool.
ume.ldap.connection_pool. max_size	Default value is 10.	Maximum number of connections in the connection pool.
ume.ldap.connection_pool. min_size	Default value is 1.	Minimum number of connections in the connection pool. For example, if this value is set to ‘1’, the connection pool never has less than 1 open connection.
ume.ldap.connection_pool. monitor_level	Default value is 1 (logging is disabled).	Interval in milliseconds at which monitoring information is written. Any value less than 1000 disables logging
ume.ldap.connection_pool. retrial	Default value is 5.	Number of attempts to open a connection if a connection fails.
ume.ldap.connection_pool. retrial_interval	Default value is 10,000.	Interval in milliseconds before retrying to open a connection.
ume.ldap.connection_pool. max_wait_time	Default value is 60,000.	Maximum time in milliseconds that a process waits if no connection is available.