The update process can be different depending on whether:

• the previous version was set up with the Windows installer;
• your Orchestrator instance is in a multi-node environment.

🚧

Important!

If your packages (activities and/or workflows) are stored in a shared folder, please note that the UiPathOrchestrator.msi installer requires Write access to the aforementioned directory.

Starting with 20.4, there are more requirements for the SSL certificate of Orchestrator. Make sure your meet all prerequisites. For how to change your existing certificate, see Using a Certificate for the HTTPS Protocol.

In update scenarios, your storage type settings are kept. For more information, see this page.

Previous Version Installed with Windows Installer

To update Orchestrator from a version that was previously installed using the Windows installer, perform the following actions:

1. Back up your automation packages, web.config file, and database.
2. Run the v2020.4 UiPathOrchestrator.msi installer. Orchestrator v2020.4 is installed with the UiPathOrchestrator name, the database is updated, and all your data is migrated.
3. If you are using HAA for cache management, flush all HAA cache keys, using the following command: redis-cli -h <hostname> -p <portnumber> -a <password> flushall. Note that HAA uses port 10000 by default. For example:

redis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushall

Multi-Node Environment

In a multi-node environment, upgrading is done differently on primary and secondary nodes. The below steps need to be taken to update all your nodes.

📘

Note:

Although you provide the admin passwords at host and default tenant level, they are not taken into account. Use your previous passwords to log in.

Backup Files

Back up your automation packages, web.config file, and database.

Install

Primary Node

For Attended Installation: Run from the Admin Command Prompt the following command:

UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* ugprade.log

For Unattended Installation: Run from the Admin Command Prompt the following command:

UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* ugprade.log /Q

Follow through with the installation as described here.

🚧

Important

Do not forget to back up the upgradeParams.json configuration file generated by the installation. This is to be used on subsequent, secondary node installations.

Secondary Nodes

It is recommended to run the unattended install, using the upgradeParams.json configuration file produced on the primary node. Run from the Admin Command Prompt the following command:

UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* ugprade.log /Q

Flush Keys

If you are using HAA for cache management, flush all HAA cache keys, using the following command: redis-cli -h <hostname> -p <portnumber> -a <password> flushall. Note that HAA uses port 10000 by default. For example:

redis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushall

🚧

Important!

If you want to use the Concurrent Runtime license type, please note that when updating to v2020.4 from an older version, if you have High-Density Robots set up, the number of runtimes per machine is automatically set to 1, and not the total number of Robots on that machine.