This page last changed on Feb 17, 2011 by smaddox.
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.
To configure your LDAP connection pool:
- Log in as a user with the 'JIRA Administrators' global permission.
- Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
- Select 'User Directories' from the 'Users, Groups & Roles' section of the 'Administration' menu.
- 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. |
1 |
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 0 (zero) means that there is no preferred size, so the number of idle connections is unlimited. |
10 |
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 0 (zero) means that the number of connections is unlimited. |
0 |
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 0 (zero) means that the idle time is unlimited, so connections will never be timed out. |
30 |
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:
|
plain ssl
(Both plain and ssl) |
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:
|
simple |
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 the LDAP directory server for these settings to take effect.
RELATED TOPICS
Connecting to an LDAP Directory
Configuring User Directories
|