Subscribe

UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Changing the Orchestrator / Identity Server URL

If you decide to manually upgrade your Orchestrator instances from single node to multi-node, you have to change the Orchestrator URL. If this is the case, you also have to change Identity Server's URL.

Several steps are required when changing the Orchestrator or Identity Server public address, in order to maintain Orchestrator fully functional. This page describes these steps.

Changing the Identity Server URL

  1. Update the ExternalAuth.System.OpenIdConnect.Authority, ExternalAuth.System.OpenIdConnect.RedirectUri, ExternalAuth.System.OpenIdConnect.PostLogoutRedirectUri and IdentityServer.Integration.Authority parameters within Orchestrator's UiPath.Orchestrator.dll.config (formerly web.config) with the new public address of Identity Server.
  2. Update the IdentityServerAddress parameter within Identity Server's appsettings.Production.json file with the new public address of Identity Server.

Changing the Orchestrator URL

  1. Open the ClientRedirectUris table inside Identity Server's database and locate the [RedirectUri] field with the https://[OldOrchestratorAddress]/signinsystemopenidconnect value. Change the value to https://[NewOrchestratorAddress]/signinsystemopenidconnect.
  2. Open the ClientPostLogoutRedirectUris table inside Identity Server's database and locate the [PostLogoutRedirectUri] field with the https://[OldOrchestratorAddress]/ value. Change the value to https://[NewOrchestratorAddress]/.
  3. Update the OrchestratorUrl parameter within Identity Server's appsettings.Production.json file with the new public address of Orchestrator.
  4. Update the ExternalAuth.System.OpenIdConnect.RedirectUri parameter within Orchestrator's UiPath.Orchestrator.dll.config (formerly web.config) with the new value https://[NewOrchestratorAddress]/signinsystemopenidconnect.
  5. Update the ExternalAuth.System.OpenIdConnect.PostLogoutRedirectUri parameters within Orchestrator's UiPath.Orchestrator.dll.config (formerly web.config) with the new value https://[NewOrchestratorAddress]/.

📘

Note:

Replace [OldOrchestratorAddress] and [NewOrchestratorAddress] with your actual Orchestrator URL addresses.

Make sure the certificates you use have the appropriate permissions set to prevent an internal server error. Refer to Troubleshooting Certificates for more details.

The Platform Configuration Tool provides as an alternative way to change the Orchestrator URL.

Updated 4 months ago


Changing the Orchestrator / Identity Server URL


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.