Uninstall and reinstall an Okta Provisioning Agent

Before you remove an Okta Provisioning Agent, Okta recommend that you have one or more additional agents configured to avoid an interruption of service. When you uninstall and reinstall an Okta Provisioning Agent, you must decide whether or not you also want to remove the old Okta token. If you are performing an upgrade, removingthe token is not mandatory. To remove the API token, you must delete the Okta Provisioning Agent folder, and then deactivate and remove your old agent.

Uninstall on Linux

  1. Sign in to your Linux server as root.
  2. Enter yum remove OktaProvisioningAgent.

Uninstall on Windows

  1. On your Windows desktop, go to StartControl PanelProgramsPrograms and Features.
  2. Select Okta Provisioning Agent, and then click Uninstall.
  3. Go to \Program Files (x86)\Okta and delete the Okta Provisioning Agent folder. Deleting this folder removes the agent configuration data and the API Token from your hard drive. The API token for the server is still valid in Okta so it is important to remove the configuration data.

Reinstall the Okta Provisioning Agent

Installing the Okta Provisioning Agent does not overwrite the configuration data in the Okta Provisioning Agent folder. If you want to reinstall and create a new API token, delete the Okta Provisioning Agent folder before you reinstall the provisioning agent. Then perform the following steps to reinstall the Okta Provisioning Agent and deactivate and remove the old Okta Provisioning Agent.

  1. Install the Okta Provisioning Agent. See Install the Okta Provisioning Agent.
  2. On the Okta Admin Console, go to DashboardAgents.
  3. Confirm that your reinstalled Okta Provisioning Agent appears in the list. You should always have at least one Okta Provisioning Agent online with a status of Active.
  4. Note: If you are performing an upgrade or reinstallation and you do not want to revoke the Okta API token of the old provisioning agent, the procedure is complete. Otherwise, proceed to the next step.

  5. In On-Premises Agents, click the Activate drop-down menu of the old agent and then select Deactivate. The status changes to Inactive.
  6. Select the Inactive drop-down menu for the agent that you want to remove, and then select Delete.
  7. For all on-premises provisioning apps, set the new agent as one of the provisioning agents that serve that app or connector.