orchestrator
2020.10
false
- Getting Started
- Requirements
- Best Practices
- Installation
- Updating
- Identity Server
- High Availability Add-on
Updating Using the Windows Installer
OUT OF SUPPORT
Orchestrator Installation Guide
Last updated Dec 12, 2023
Updating Using the Windows Installer
Warning: Please keep in mind that this information pertains to
the version that you are upgrading to, NOT to the version that you are upgrading
from. As such, make sure that you read the correct details before
proceeding.
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:Important: Before upgrading, please visit the Hardware Reqirements, Software Reqirements and prerequisites pages, for the version you are upgrading to, as they may have changed. You need to ensure you meet all requirements prior to upgrade.Important: After upgrading to v2020.10, we recommend that you restart all your robots in order for them to apply the new settings.Important: If your packages (activities and/or workflows) are stored in a shared folder, please note that theUiPathOrchestrator.msi
installer requires Write access to the aforementioned directory.Important: Starting with v2020.4, there are more requirements for the SSL certificate of Orchestrator. Make sure you meet all prerequisites. For how to change your existing certificate, see Using a Certificate for the HTTPS Protocol.Important: Double-check the selected installation path. Moving an installation from one location to another post-install is not supported.
To update Orchestrator from a version that was previously installed using the Windows installer, perform the following actions:
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.
Back up your automation packages,
web.config
and UiPath.Orchestrator.dll.config
files, and database.
For Attended Installation: Run from the Admin Command Prompt the following command:
UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\) emp\upgradeParams.json /lvx* upgrade.log
UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\) emp\upgradeParams.json /lvx* upgrade.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:\) emp\upgradeParams.json /lvx* upgrade.log /Q
UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\) emp\upgradeParams.json /lvx* upgrade.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.
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* upgrade.log /Q
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
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
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.