Change the number of Okta LDAP agent threads

You can configure the number of threads the Okta LDAPLightweight Directory Access Protocol (LDAP) is a lightweight client-server protocol for accessing directory services, specifically X.500-based directory services. LDAP runs over TCP/IP or other connection oriented transfer services. agentA software agent is a lightweight program that runs as a service outside of Okta. It is typically installed behind a firewall and allows Okta to tunnel communication between an on-premises service and Okta's cloud service. Okta employs several agent types: Active Directory, LDAP, RADIUS, RSA, Active Directory Password Sync, and IWA. For example, users can install multiple Active Directory agents to ensure that the integration is robust and highly available across geographic locations. uses to poll the server for tasks. If you are running the LDAP agent on a large-scale server, you can increase the thread count as an alternative to using multiple LDAP agents.

Note: There is a 10 thread limitation for this feature. The default is 2.

For example to use four polling threads:

  1. Before opening or modifying the LDAP agent configuration files, stop the LDAP agent service under Windows Services.
  2. From the terminal, locate the OktaLDAPAgent.conf file for each LDAP agent server: 

    C:\Program Files\Okta\Okta LDAP Agent\conf\OktaLDAPAgent.conf

  3. Open the OktaLDAPAgent.conf file in a suitable text editor program and then locate the following line:

    pollingThreadCount = 2

    The default value is 2 and the valid range is 1 - 10. As an example to increase the number of polling threads to four, edit the line to look like this:

    pollingThreadCount = 4

  4. Once the change has been made, save the file and then start the Okta LDAP agent service again. You can verify that the setting has changed by opening the agent.log file at startup and observing the startup information towards the bottom of the file:

    [2019-02-27 12:27:52.154 ] [ main ] [ INFO ] [LdapAgent:182] - Started up 4 polling threads.

Now the agent has four concurrent polling threads searching for actions to perform.

Related topics

Install and configure the Okta LDAP Agent

Locate the Okta LDAP agent log

LDAP configuration parameters

Reconfigure an Okta LDAP agent

Uninstall or re-install the Okta LDAP agent