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:

1. Disable swap:

sudo swapoff -a

2. To persist this change through reboots, delete the swap partition in the etc/fstab file.
3. 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

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

1. View information about the currently installed locale by running either or the following commands:

locale -a

localectl

2. 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:

1. SSH the primary node with root permissions.
2. Create the directory where you want to download and extract HAA, for example:

mkdir haa

3. Download the get-haa.sh installation script:

wget https://download.uipath.com/haa/get-haa.sh

📘

See the Script parameters section for more details.

4. Make the get-haa.sh script executable:

chmod a+x get-haa.sh

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

1. SSH the secondary node with root permissions.
2. Create the directory where you plan to download and extract HAA, for example:

mkdir haa

3. Change to the newly created directory:

cd /<path-to>/haa/

4. Download the get-haa.sh installation script:

wget https://download.uipath.com/haa/get-haa.sh

📘

See the Script parameters section for more details.

5. Make the get-haa.sh script executable:

chmod a+x get-haa.sh

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

Configuring 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:

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

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

4. Select the databases tab and confirm that the uipath-orchestrator database appears here with a status of OK.
5. 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:

1. 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.
2. Enter the username and password provided during installation to log in.
3. Select the settings > general tab.
4. In the Cluster key field, enter your license key.
5. Click Save.

Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described here.