Subscribe

UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Azure App Service Installation

Overview


The Azure installation script enables you to install Orchestrator on one or multiple nodes.

🚧

Important!

All the steps are mandatory in the installation procedures listed below. Orchestrator does not work without installing Identity Server.

Single Node Installation


To install Orchestrator on an Azure App Service perform the following steps:

Orchestrator Steps

  1. In the Azure Portal, under App Services, create a new app service with a custom name such as UiPathOrchestrator. When creating the web app, make sure to select the Stack .NET Core 3.1. For more information, see Microsoft's official documentation.
  2. Open the newly created web app in the Azure Portal, and on the Configuration tab, select General Settings, then make the following configuration changes:
    • Set Platform to 64-bit.
    • Set Web Sockets to On.
  3. Set the database connection string in the Application Settings of the web app, with the name Default. For example, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

🚧

Important!

The Azure SQL user provided here must have access at the server level, database level access is not sufficient for a successful installation.

  1. Create an Azure AD application and service principal that can access your Orchestrator App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Identity Server Steps

  1. In the Azure Portal, under App Services, create a new app service with a custom name such as UiPathIdentity. When creating the web app, make sure to select the Stack .NET Core 3.1. For more information, see Microsoft's official documentation.
  2. Set the database connection string in the Application Settings of the web app, with the name DefaultConnection. For example, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
  3. Navigate to Settings > Configuration > General Settings tab and select 64-bit for the Platform.
  4. Create an Azure AD application and service principal that can access your Identity App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

General Steps

  1. Download the UiPathOrchestrator.zip archive to your local machine. This contains all the scripts necessary to install Orchestrator, Identity Server, and Webhooks Service. UiPath provides the UiPathOrchestrator.zip archive on request. Contact us for details.
  2. Extract the content of the zip file into a folder on your machine.
  3. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here. Check out this example.
  4. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here and complete the process as described here.
  5. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here. Check out this example.
  6. Install the Webhooks Service.
  7. Start the Orchestrator and Identity app services. Enjoy using Orchestrator on your Azure Portal.

Multi-node Installation


To install Orchestrator on multiple nodes on an Azure App Service perform the following steps:

Orchestrator Steps

  1. In the Azure Portal, under App Services, create a new app service with a custom name such as UiPathOrchestrator. When creating the web app, make sure to select the Stack .NET Core 3.1. For more information, see Microsoft's official documentation.
  2. Open the newly created web app in the Azure Portal, and on the Configuration tab, select General Settings, then make the following configuration changes:
    • Set Platform to 64-bit.
    • Set Web Sockets to On.
  3. Set the database connection string in the Application Settings of the web app, with the name "Default". For example, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

🚧

Important!

The Azure SQL user provided here must have access at the server level, database level access is not sufficient for a successful installation.

  1. Create an Azure AD application and service principal that can access your Orchestrator App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.
  2. In the Scale out (App Service plan) tab, select the Scale to a specific instance count option and provide the desired Instance count.

Identity Server Steps

  1. In the Azure Portal, under App Services, create a new app service with a custom name such as UiPathIdentity. When creating the web app, make sure to select the Stack .NET Core 3.1. For more information, see Microsoft's official documentation.
  2. Set the database connection string in the Application Settings of the web app, with the name DefaultConnection. For example, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
  3. Navigate to Settings > Configuration > General Settings tab and select 64-bit for the Platform.
  4. Create an Azure AD application and service principal that can access your Identity App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

General Steps

  1. Download the UiPathOrchestrator.zip archive to your local machine. This contains all the scripts necessary to install Orchestrator, Identity Server, and Webhooks Service. UiPath provides the UiPathOrchestrator.zip archive on request. Contact us for details.
  2. Extract the content of the zip file into a folder on your machine.
  3. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here. Check out this example.
  4. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here and complete the process as described here.
  5. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here. Check out this example.
  6. Install the Webhooks Service.
  7. Start the Orchestrator and Identity app services. Enjoy using Orchestrator on your Azure Portal.

Updated 5 days ago



Azure App Service Installation


Suggested Edits are limited on API Reference Pages

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