About Installation

Overview

To see the latest available versions, please check the Release Notes page.

Preinstallation Checklist

Before proceeding with an Orchestrator upgrade/installation, carefully review the following task list:

Description	Details
Review the system requirements	Ensure that you meet the prerequisites, hardware and software requirements for the version you want to install. Hardware Requirements Software Requirements Prerequisites
Learn about changes introduced by the new deployment	A new Orchestrator deployment brings about changes that you should be aware of. Some of the items must be taken care of before an upgrade/installation. Some are notes on the biggest changes and recommendations on how to get the best of the new version. Changed the runtime from .NET Framework to .NET Core Made several changes to the configuration files Updated the SignalR protocol. Revamped the NuGet infrastructure. Updated the Swagger library. API changes
Run the Platform Configuration Tool	The Platform Configuration Tool is a PowerShell script used to assist you in the successful installation/upgrade of Orchestrator. It helps you check the sanity and readiness of your environment before an upgrade, and assists you in performing several operations post-installation. Platform Configuration Tool documentation and download.

Installing Orchestrator

Installation artifacts are provided when you first purchase Orchestrator or they can be provided by your customer success manager or our support team. If you want to try our products prior to purchasing, check out the trial versions on our website here.

Windows Installer

The UiPathOrchestrator.msi installer performs a complex installation of Orchestrator and all its components, on one or multiple nodes. The repair functionality of the Windows Installer is not supported.

It enables you to perform the following:

• install on one or multiple nodes;
• configure the IIS settings (website + app pool);
• add firewall rules for the chosen website port;
• configure database settings for an SQL Server database;
• automatically sets up all NuGet feeds for packages and activities;
• set up Identity Server for centralized authentication and access control across UiPath products;
• set up Elasticsearch for logging;
• enable Windows authentication.
• enable Webhooks services

By default Orchestrator is installed in the C:\Program Files (x86)\UiPath\Orchestrator directory.

Important: Double-check the selected installation path. Moving an installation from one location to another post-install is not supported.

Learn how to install using the Windows installer.

Important: You cannot change the website and the application pool names.

Azure Script

The Azure installation script enables you to install and configure all the same components as the Windows installer and scripts, with one or more multiple nodes. This script is differentiated from the other by the fact that it can help you install Orchestrator in the Azure Portal, with app services.

Learn how to install using the Azure script.

Installation Considerations

Database

Regardless of how you choose to update, if the database you point to does not exist, it is automatically created during the installation.

Privacy

UiPath collects usage and performance data to help diagnose problems and help improve Orchestrator. For more details about UiPath’s privacy practices, please review the privacy statement.

Important:

Before installing the UiPath Orchestrator, please go through all the steps provided in Prerequisites for Installation.

Logging in to Orchestrator using the Internet Explorer or Edge web browsers does not work if the name of your website contains an underscore (“_”), such as https://orchestrator_tests.com.

Scheduling

Regardless of the type of installation, in order for the scheduling features to work properly, you must ensure that:

• in clustered mode the clocks on all machines have to be synchronized within less than one second;
• the clocks for the database and Orchestrator machines also have to be synchronized;
• if the SQL database enters a faulted state it is recommended to restart the Orchestrator webserver from IIS. If you are in an NLB environment, please restart all web servers.

Modifying an Orchestrator Installation

Important: Double-check the selected installation path. Moving an installation from one location to another post-install is not supported.

After installing Orchestrator, you can modify the installation to add or remove optional features: Insights and/or Test Automation.

Modifying Via Installer

Go to Add/Remove Programs, select UiPath Orchestrator and choose Change. You can enable/disable any of the two modules from the Features screen. You will then be taken to their corresponding configuration screens, which are the same as from the installation flow.

Modifying Via Command Line

To add both features, after you have installed Orchestrator without them, run from an Admin Command Prompt:

UiPathOrchestrator.msi ADDLOCAL=InsightsFeature,TestAutomationFeature DB_INSIGHTS_DATABASE_NAME=UiPathInsights DB_INSIGHTS_SERVER_NAME=.\sqlexpress DB_INSIGHTS_AUTHENTICATION_MODE=WINDOWS TA_DATABASE_NAME=UiPathTestAutomation /Q /l*vx log.txt

To remove one or both features, after installation, use the REMOVE parameter:

UiPathOrchestrator.msi REMOVE=InsightsFeature,TestAutomationFeature /Q /l*vx log.txt