Orchestrator installation guide

DELIVERY:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated Feb 20, 2025

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 [PostLogoutRedirectUri] = REPLACE([PostLogoutRedirectUri], @CurrentServerName, @NewServerName)
WHERE [PostLogoutRedirectUri] LIKE '%' + @CurrentServerName + '%'; -- Update only if the row contains 'server1'-- 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 [PostLogoutRedirectUri] = REPLACE([PostLogoutRedirectUri], @CurrentServerName, @NewServerName)
WHERE [PostLogoutRedirectUri] LIKE '%' + @CurrentServerName + '%'; -- Update only if the row contains 'server1'

Updating the Orchestrator and Identity Server configuration file

Make sure that the IdentityServer.Integration.Authority parameter within the Orchestrator's UiPath.Orchestrator.dll.config is accurately pointing to the correct Identity Server public address.

See more details about the Identity Server app settings in UiPath.Orchestrator.dll.config.

On this page