UiPath Orchestrator Guide

Updating Using the Scripts

Important!

If you want to update Orchestrator a second time (either because you wish to use a different target Orchestrator version or if an error has occurred during the process), the Upgrade-Orchestrator.ps1 script must be called using a new PowerShell window.
The migration process is not going to be rolled back in case of failure.

To update an older version of Orchestrator, perform the following actions:

  1. On the machine on which the older version of Orchestrator is installed, download the following archive in a new folder, such as C:\OrchestratorKit:
  2. Unblock the UiPathOrchestrator.zip file:
    2.1. Right-click the UiPathOrchestrator.zip file. The Properties window is displayed.
    2.2. Select the Unblock checkbox and click OK.
  1. Unarchive the UiPathOrchestrator.zip file.
  2. Back up your automation packages and database.
  3. Open PowerShell in an elevated mode, as an Administrator.
  4. Ensure that the execution policy is set to bypass. If it is not set to bypass, run the following command: Set-ExecutionPolicy Bypass -Scope Process, and select Yes to All by pressing the A key and then Enter.
  5. Change the directory to the one where you downloaded the update files. For example, cd C:\OrchestratorKit.
  6. Run the .\Upgrade-Orchestrator.ps1 script.
  7. (Optionally) If Orchestrator is installed on 2 or more nodes connected together by a Load Balancer (High Availability), repeat steps 1-6 on all the Orchestrator nodes.
  8. a. If the name of the existing website is UiPathOrchestrator, press Enter when you are asked for the website name.
    b. If the name of the existing website is NOT UiPathOrchestrator, please enter the name of the website as it appears in IIS and press Enter.
    Orchestrator v2018.1 can now be started from IIS and used with all the data that existed in the previous version. If Orchestrator is installed on multiple nodes, start all sites.

The old version of Orchestrator is backed up in the installation folder, in a directory that is named according to the following format: UiPathOrchestrator[version].[timestamp].backup.


Updating Using the Scripts