Uninstall or reinstall the Okta LDAP Agent

When you uninstall and reinstall your Okta LDAP Agent, you can remove the existing Okta API token. If you are performing an upgrade, you don't need to remove the Okta API token.

To continue using an Okta LDAP Agent and to avoid down time, you must have at least two agents running before you uninstall one of them.

Uninstall the Okta LDAP Agent on Windows

  1. On your Windows server, click StartControl PanelProgramsPrograms and Features.
  2. Select the Okta LDAP Agent, and then click Uninstall/Change.
  3. To remove the agent configuration data from the hard drive, on the agent server, go to C:\Program Files\Okta and delete the Okta LDAP Agent folder. Deleting this folder removes the agent configuration data from your hard drive.

Uninstall the Okta LDAP Agent on Linux

On your Linux server, open a command prompt and run one the following commands:

Debian: dpkg --purge OktaLDAPAgent

RPM: yum remove OktaLDAPAgent

The preceding commands remove the agent and its configuration data from your hard drive.

Reinstall the Okta LDAP Agent

Installing the Okta LDAP Agent doesn't overwrite the configuration data in the Okta LDAP Agent folder. Delete the Okta LDAP Agent folder before you reinstall the Okta LDAP Agent.

  1. Install the Okta LDAP Agent. See Install the Okta LDAP Agent.
  2. In the Admin Console, go to DirectoryDirectory Integrations.
  3. Click LDAP and the Agents tab.
  4. Confirm that your reinstalled Okta LDAP Agent appears in the Agent Monitors section and it is connected to Okta. A minimum of one Okta LDAP Agent should be online.