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.
• Make sure to set the TrustServerCertificate attribute in the database connection string to True.
• To set a database connection string for the Test Automation module, follow the steps described for the -testAutomationFeatureEnabled parameter in Publish-Orchestrator.ps1 Parameters.

4. 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

5. 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.
6. 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.

🚧

Important!

Make sure to set the TrustServerCertificate attribute in the database connection string to True.

7. Navigate to Settings > Configuration > General Settings tab and select 64-bit for the Platform.
8. 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

9. 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.
10. Extract the content of the zip file into a folder on your machine.
11. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here. Check out this example.

🚧

Important!

Before running the Publish-Orchestrator.ps1 script, make sure you uninstall the AzureRM PowerShell module. We recommend using the Az PowerShell module as an alternative. Having both AzureRM and Az modules installed at the same time is not supported.

If the desired Az version is not detected, and AzureRM is present when running the script, you are prompted to confirm the AzureRM removal even on unattended installations.

12. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here and complete the process as described here.
13. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here. Check out this example.
14. Install the Webhooks Service.
15. 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.
• Make sure to set the TrustServerCertificate attribute in the database connection string to True.

4. 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.
5. 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

6. 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.
7. 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.

🚧

Important!

Make sure to set the TrustServerCertificate attribute in the database connection string to True.

8. Navigate to Settings > Configuration > General Settings tab and select 64-bit for the Platform.
9. 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

10. 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.
11. Extract the content of the zip file into a folder on your machine.
12. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here. Check out this example.

🚧

Important!

Before running the Publish-Orchestrator.ps1 script, make sure you uninstall the AzureRM PowerShell module. We recommend using the Az PowerShell module as an alternative. Having both AzureRM and Az modules installed at the same time is not supported.

If the desired Az version is not detected, and AzureRM is present when running the script, you are prompted to confirm the AzureRM removal even on unattended installations.

13. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here and complete the process as described here.
14. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here. Check out this example.
15. Install the Webhooks Service.
16. Start the Orchestrator and Identity app services. Enjoy using Orchestrator on your Azure Portal.