Configuring agent behavior

When listing from an LDAP Directory Service target that supports paging, agtldap uses a default page size of 500. This page size must either be equal to or less than the size limit that is defined on the LDAP server. If the page size is greater than the size limit on the LDAP server, agtldap does not use paging.

Paging enables a specified number of users to be listed "per page" rather than at the same time. This feature allows clients connecting to the LDAP server to get around restrictions limiting the number of users that can be returned from a query. A paged search is generally faster than a non-paged search.

To change the page size used by agtldap , modify the address section of the sample agtldap configuration file to include the following key:

"" "" = {
     "address" "" = {
  ...
       "pageSize" = "<int>"
  ...
     }
  }

where <int> is the page size limit.

Most LDAP severs such as IBM Directory Server and OpenLDAP use paging; however, some servers such as Netscape and SunOne Directory server do not. To determine whether your LDAP server uses paging, check if 1.2.840.113556.1.4.319 is included as a supported control. For details, visit: http://www.ietf.org/rfc/rfc2696.txt .

If your target does not support paging and you find that agtldap does not return a complete list, increase the search size or "lookthrough" limit. Consult your LDAP administrator or documentation for more information.