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

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

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

For example, to create three instances:

  1. 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 text editor and then locate the following entry:

    <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

Related topics

Provisioning and Deprovisioning