Change the number of Okta Active Directory (AD) agent threads

You can configure the number of threads the AD 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 AD agent on a large-scale server, you can increase the thread count as an alternative to using multiple AD agents.

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

For example, to create three instances, do the following:

  1. Before opening or modifying the AD agent configuration files, stop the AD agent service under Windows Services.
  2. From the terminal, locate the OktaAgentService.exe.instances.config file for each AD agent server: 

    C:\Program Files (x86)\Okta\Okta AD Agent\OktaAgentService.exe.config

  3. Open the 'OktaAgentService.exe.config' file in a suitable text editor program and then locate the following line:

    <add key="PollingThreads" value="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:

    <add key="PollingThreads" value="4" />

  4. Save the file.
  5. Start the agent.
  6. Once the change has been made, save the file and then start the Okta AD 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:

    2017/07/21 06:06:22.167 Debug – TEST-SERVER-1(4) – PollingThreads: 4

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

Related Topics Link IconRelated Topics