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:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. 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.
  3. Select 'User Directories' from the 'Users, Groups & Roles' section of the 'Administration' menu.
  4. 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
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:
  • none
  • simple
  • DIGEST-MD5
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

Document generated by Confluence on Mar 27, 2011 18:31