Installation overview
We support backwards compatibility with Orchestrator but recommend updating to the latest HAA version.
There are two ways to install the High Availability Add-on (HAA) for your Orchestrator instance:
- quick – by downloading and executing a provided script; used when you want to set up HAA inside a single datacenter.
For details, see Quick installation. - advanced – by performing some complex operations, including cluster DNS configuration, and cluster creation and setup; used when you want to set up HAA inside multiple datacenters.
For details, see Active/Active Disaster Recovery Installation.
Before proceeding with your HAA installation, make sure that you meet the hardware and software requirements.
HAA requires a separate license from Orchestrator. Active/Active Disaster Recovery deployment model requires two HAA licenses. Contact UiPath for details.
Prerequisites
The following prerequisites are identical to both the quick and advanced installation methods. Before starting the HAA installation, ensure that you:
- are the root user or have access to
sudo
to the root user; - have user creation rights;
- ensure that you have a valid SSL/TLS certificate. Refer to Redis documentation for instructions on how to update your certificates;
- enabled firewall service.
Note:
Root permissions are required only for installation and upgrade; the HAA admin user does not need escalated permissions to administer the cluster services.
On the following daemons run by the HAA admin user, capability bits have been set to allow the executable the minimal privileges required to operate:/opt/redislabs/bin/dmcproxy = cap_sys_resource+ep /opt/redislabs/bin/redis-server-4.0 = cap_sys_resource+ep /opt/redislabs/bin/redis-server-4.0-big = cap_sys_resource+ep /opt/redislabs/bin/redis-server-5.0 = cap_sys_resource+ep /opt/redislabs/bin/redis-server-5.0-big = cap_sys_resource+ep /opt/redislabs/bin/sentinel_service = cap_sys_resource+ep /opt/redislabs/sbin/pdns_server = cap_net_bind_service+ep /opt/redislabs/sbin/smaps = cap_sys_ptrace+ep
These allow the HAA admin user to run these services with privilege without requiring the user to have the privileges assigned.
- disable Swap:
- Disable
swap
:
sudo swapoff -a
- To persist this change through reboots, delete the
swap
partition in theetc/fstab
file. - Install the
wget
package. Make sure to use a download command supported by your Linux distribution. For example, if you use CentOS, run:
yum install wget
- Repeat this process on all nodes where you plan to install HAA.
- check if English is added to the list of languages.
Depending on your language and character set (encoding), you may experience issues while running the installation script. It is recommended that you first check if English is added to the list of languages, as follows:
- View information about the currently installed
locale
by running either or the following commands:
locale -a
localectl
- Set English as the language and encoding for the current session, by running:
$ export LANG="en_US.utf8"
Quick installation
Important!
Before proceeding with the quick installation of HAA, make sure all your nodes meet the prerequisites.
Installing the primary node
To install HAA on the primary node, take the following steps:
- SSH the primary node with root permissions.
- Create the directory where you want to download and extract HAA, for example:
mkdir haa
- Download the
get-haa.sh
installation script:
wget https://download.uipath.com/haa/get-haa.sh
See the Script parameters section for more details.
- Make the
get-haa.sh
script executable:
chmod a+x get-haa.sh
- Install the primary node. Make sure to provide an email address and password for the administrator account. You can use a temporary email address. You also need to specify the operating system running on the node.
sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreement
Important!
To install HAA in a custom location, run the
install-haa.sh
script for advanced configuration (this does not create any cluster), keeping in mind that all locations must be different. For example:
sudo ./install-haa.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath
.Double-check the selected installation path. Moving an installation from one location to another post-installation is not supported.
Installing the secondary nodes
After installing the primary node, take the following steps on each secondary node:
- SSH the secondary node with root permissions.
- Create the directory where you plan to download and extract HAA, for example:
mkdir haa
- Change to the newly created directory:
cd /<path-to>/haa/
- Download the
get-haa.sh
installation script:
wget https://download.uipath.com/haa/get-haa.sh
See the Script parameters section for more details.
- Make the
get-haa.sh
script executable:
chmod a+x get-haa.sh
- Install the secondary node:
sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement
Important!
Provide the email address, password, and IP address set when creating the primary node.
Script parameters
The following parameters are available when running the get-haa.sh
installation script:
Parameter | Decription |
---|---|
-u | The username of the HAA cluster administrator. Example: -u documentation@uipath.com |
-p | The password for the administration user, set when installing the primary node. Example: -p SuperSecret_Password |
-d | The IP address of the DNS. |
-j | The IP address of the primary node. When provided, a secondary node is installed. Example: -j 10.10.22.10 |
-h | Used to display the installation help guide. |
-l | The license code for your HAA cluster. Make sure to enter the license without the starting and trailing --- LICENSE START --- or --- LICENSE END --- and without any new line characters. |
-o | The operating system of the node. Supported values: Rhel8 , Rhel7 , Ubuntu .Example: -o Rhel8 |
--manual | Use to manually configure the cluster via the UI. |
--advanced | This optional argument will not install HAA, but download and decompress the HAA package. Also, it displays the help with more optional arguments for the advanced installation. |
--accept-license-agreement | Accept the UiPath license agreement |
--offline | For offline installation. It assumes the package is in the current folder, same as the installation script. You can find the link for the package in the get-haa.sh script. |
--verbose | Verbose mode. |
Configuring UiPath.Orchestrator.dll.config
UiPath.Orchestrator.dll.config
You must configure Orchestrator to use HAA and add all HAA nodes to the Orchestrator's UiPath.Orchestrator.dll.config
configuration file using the LoadBalancer.UseRedis
and LoadBalancer.Redis.ConnectionString
parameters. For example:
<add key="LoadBalancer.UseRedis" value="true" />
<add key="LoadBalancer.Redis.ConnectionString" value="10.10.20.184:10000,10.10.24.148:10000,10.10.22.114:10000,password=SuperSecret_Password" />
Verifying the cluster installation
After installing all nodes of your HAA cluster, confirm the successful configuration as follows:
- Using your browser, navigate to the IP address of any HAA node on port
8443
. For example:https://10.10.20.196:8443/
. The HAA login page is displayed.

- Log into HAA using the username and password provided during installation.
- Select the nodes tab and verify that all installed nodes are listed with a status of OK.

- Select the databases tab and confirm that the
uipath-orchestrator
database appears here with a status of OK. - If deployed on more than one node, ensure that Replication is enabled in the database settings, and that two nodes are showing a shard count of 1. This ensures that the database is replicated on two nodes.
Note:
By default, the database is created on port
10000
with the password provided at installation.
Licensing HAA
To add or update your High Availability Add-on license, take the following steps:
- Using your browser, navigate to the IP address of any HAA node on port
8443
. For example:https://10.10.20.196:8443/
. The HAA login page is displayed. - Enter the username and password provided during installation to log in.
- Select the settings > general tab.
- In the Cluster key field, enter your license key.
- Click Save.
Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described here.
Updated about a month ago