Changing the Orchestrator / Identity Server URL

If you decide to manually upgrade your Orchestrator / Identity Server instances from single node to multi-node, you may need to change the Orchestrator / Identity Server URL. The case where you should change the Orchestrator / Identity Server URL is when the load balancer URL is used in a multi-node installation, as it is independent from any node name.

If the single-node installation is configured to be used by a load balancer, upgrading to a multi-node installation does not require changing the public 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.

Updating the database

For updating the Orchestrator / Identity Server URL, follow the below SQL query, where you first declare variables for the current server name and the new server name, and then update the statement using REPLACE function.

-- Declare variables for the current server name and the new server name DECLARE @CurrentServerName NVARCHAR(255) = 'server1'; -- Input: e.g., 'server1' 
DECLARE @NewServerName NVARCHAR(255) = 'server2'; -- Input: e.g., 'server2'  

-- Update statement using REPLACE function 
UPDATE identity.ClientRedirectUris 
SET RedirectUri = REPLACE(RedirectUri, @CurrentServerName, @NewServerName)
WHERE RedirectUri LIKE '%' + @CurrentServerName + '%'; -- Update only if the row contains 'server1'  

UPDATE identity.ClientPostLogoutRedirectUris SET RedirectUri = REPLACE(RedirectUri, @CurrentServerName, @NewServerName) 
WHERE RedirectUri LIKE '%' + @CurrentServerName + '%'; -- Update only if the row contains 'server1'

Updating the Orchestrator and Identity Server configuration file

1. Update the OrchestratorUrl parameter within Identity Server's appsettings.Production.json file with the new public address of Orchestrator.
2. Update the ExternalAuth.System.OpenIdConnect.RedirectUri parameter within Orchestrator's UiPath.Orchestrator.dll.config (formerly web.config) with the new value https://[NewOrchestratorAddress]/signinsystemopenidconnect.
3. 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.