Configuring the LDAP Connection Pool
When connection pooling is enabled, the LDAP directory server maintains a pool of connections and assigns them as needed. When a connection is closed, the directory server returns the connection to the pool for future use. This can improve performance significantly.
Related pages:
To configure your LDAP connection pool:
- Choose the cog icon
, then choose General Configuration - Click 'User Directories' in the left-hand panel.
- Click 'LDAP Connection Pool Configuration' in the 'Additional Configuration' section.
Setting |
Description |
Default Value |
|---|---|---|
Initial Pool Size |
The number of LDAP connections created when initially connecting to the pool. |
|
Preferred Pool Size |
The optimal pool size. LDAP will remove idle connections when the number of connections grows larger than this value. A value of |
|
Maximum Pool Size |
The maximum number of connections. When the number of connections reaches this value, LDAP will refuse further connections. As a result, requests made by an application to the LDAP directory server will be blocked. A value of |
|
Pool Timeout (seconds) |
The length of time, in seconds, that a connection may remain idle before being removed from the pool. When the application is finished with a pooled connection, the connection is marked as idle, waiting to be reused. A value of |
|
Pool Protocol |
Only these protocol types will be allowed to connect to the LDAP directory server. If you want to allow multiple protocols, enter the values separated by a space. Valid values are:
|
|
Pool Authentication |
Only these authentication types will be allowed to connect to the LDAP directory server. If you want to allow multiple authentication types, enter the values separated by a space. See RFC 2829 for details of LDAP authentication methods. Valid values are:
|
|
Notes:
- The connection pool settings are system wide and will be used to create a new connection pool for every configured LDAP directory server.
- You must restart your application server for these settings to take effect.