UiPath Orchestrator

The UiPath Orchestrator Guide

About Updating and Migrating



Prior to upgrading to v2019, make sure that you are not using the same MachineKey on different hosts when connecting your unattended robots. Due to changes in the robot heartbeat, this can result in connectivity issues.

It is possible to directly update your Orchestrator to v2019 in the following cases:

  • You have any 2016.2 version
  • You have any 2017.1 version (except 2017.1.6435)
    Note: To upgrade from version 2017.1.6435 to any 2019 version, or later, you must first upgrade to another intermediate version (e.g. 2018.4).
  • You have any 2018.x version
  • You have any 2019.x version
    To see the latest available versions, please check the Release Notes page.



Upgrades of your Orchestrator must be made with the application stopped. Performing any updates while the application is running can result in errors and is not supported.

There are a few ways to directly update:

  1. Using the Windows Installer (UiPathOrchestrator.msi) - An in-place update that copies all your settings and creates a backup folder for the old version. It is suitable for both one node and multi-node architecture. Please note that some web.config settings are not copied if the version you are upgrading from was installed using the deprecated scripts.
    Please note that the repair functionality of the Windows Installer is not supported.
  2. Using the Azure Script - a complex update of Orchestrator and its components on one or multiple nodes, in the Azure Portal.
  3. Using the UiPathPlatform installer - An executable file which enables you to update Orchestrator, Robot, and Studio. It is suitable for one-node architectures.

These artifacts are provided when you first purchase Orchestrator or they can be provided by your customer success manager or our support team.

Regardless of the way you choose to update, please note that if the database you point to does not exist, it is automatically created while running the update. If you point to an existing database, it is updated during the same process.

The Orchestrator SQL database is automatically set to be case-insensitive (“OrchDB” = “orchdb”), at installation.

The UiPath Platform Installer

The UiPathPlatformInstaller.exe is an installer application which bundles all our products and enables you to update Orchestrator, Robot, and Studio. The processes are exactly the same as the ones you would go through using the Windows installers, UiPathStudio.msi and UiPathOrchestrator.msi.

However, please take into consideration that the UiPathPlatformInstaller.exe does not accept command line arguments.

Updating Your License After Installation

After you upgrade or migrate Orchestrator, we recommend that you update your license information from the Licenses page using either online or offline activation. For instructions, see Activating Your License.
If you do not update your license, you do not benefit from a grace period at license expiration, which can cause service disruption.

Updated about a year ago

About Updating and Migrating

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.