- Getting Started
- Requirements
- Best Practices
- Installation
- Updating
- Identity Server
- Troubleshooting startup errors
Updating Using the Windows Installer
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 you use Active Directory (AD) and are planning on upgrading to 2023.4.0, we highly recommend that you skip straight to the 2023.4.3 version, as 2023.4.0, 2023.4.1 and 2023.4.2 are impacted by an AD issue.
- 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.
- After upgrading, we recommend that you restart all your robots in order for them to apply the new settings.
- If your packages (activities and/or workflows) are stored in a shared folder, please note that the
UiPathOrchestrator.msiinstaller requires Write access to the aforementioned directory. - 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
- Double-check the selected installation path. Moving an installation from one location to another post-install is not supported.
- It is recommended to preserve the previous Orchestrator Application Pool identity type for Identity Server and Webhooks as well. Otherwise, issues may occur while accessing the SQL server.
- If you are considering installing Insights, make sure that you select the
db_ownerrole as this is required when you configure the Insights SQL Server configuration. - If you upgrade from a version older than 2021.10 that has the Windows Authentication option selected, make sure to run the installer as an AD user.
-
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.
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:\temp\upgradeParams.json /lvx* upgrade.logUiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.logFor 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* upgrade.log /QUiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /QFollow through with the installation as described here.
upgradeParams.json configuration file generated by the installation. This is to be used on subsequent, secondary node installations.
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 CONFIRM_BLOCK_CLASSIC_EXECUTIONS=1 /QUiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log CONFIRM_BLOCK_CLASSIC_EXECUTIONS=1 /QIf you are using HAA for cache management, flush all HAA cache keys from an Active-Active database using the following command:
crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]
