Installation of the High Availability Add-on (HAA) for your Orchestrator instance is performed by downloading and executing a provided script.
Before proceeding with your HAA installation be sure that you meet the Hardware and Software Requirements.
Note:
HAA requires a separate license from Orchestrator. Contact UiPath for details.
Installation
Prerequisites
Prior to beginning the HAA installation, ensure that you:
- are the root user or have access to
sudo
to the root user. - have user creation rights.
- 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
with the command:sudo swapoff -a
. - To persist this change through reboots, comment the
swap
entry in theetc/fstab
file by running:sudo sed -i.bak '/ swap / s/^(.*)$/#1/g' /etc/fstab
. - Repeat this process on all nodes where you are installing HAA.
Also, depending on your language and character set (encoding), you may experience issues while running the installation script. It is recommended checking first if English is added to the list of languages:
- View information about the current installed
locale
used: runlocale -a
orlocalectl
. - Set English as the language and encoding for the current session, by running:
$ export LANG="en_US.utf8"
.
Master Node
- Download the installation script by running
wget http://download.uipath.com/haa/2020/2.0/get-haa.sh
. - Make the script executable by running
chmod a+x get-haa.sh
. - Install the master node with the following command:
sudo ./get-haa.sh -u <email> -p <password>
.
Provide the email and desired password for the account administrator, and the installation directories.
Important!
To install HAA in a custom location run the
install.sh
script for advanced configuration (this does not create any cluster), keeping in mind that all locations must be different. For example:
sudo ./install.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath
.
Secondary Nodes
After you have installed the primary (master) node, from each additional node:
- Create the directory where HAA is to be downloaded and extracted, for example:
mkdir haa
. - Change to the newly created directory using the command:
cd /<path-to>/haa/
. - Download the installation script by running
wget http://download.uipath.com/haa/2020/2.0/get-haa.sh
. - Make the script executable by running
chmod a+x get-haa.sh
. - Install the node with the following command:
sudo ./get-haa.sh -u <email> -p <password> -j <IP_address_of_the_master_node>
.
Provide the email and password set when creating the master node, and the IP address of the primary node.
Script Parameters
The following parameters are available when running the HAA installation script:
Parameter | Decription |
---|---|
| The username of the HAA cluster administrator. For example |
| The password for the administration user, set when installing the primary node. For example |
| The IP address of the primary node. When provided, a secondary (slave) node is installed. For example |
| Indicate the path to the HAA installation directory (only when running the |
| Indicate the path to the HAA configuration directory (only when running the |
| Indicate the path to the HAA variables directory (only when running the |
| Used to display the installation help guide. |
| The license code for your HAA cluster. |
UiPath.Orchestrator.dll.config
Configuration
UiPath.Orchestrator.dll.config
ConfigurationYou must configure Orchestrator to use HAA and add all HAA nodes to the Orchestrator UiPath.Orchestrator.dll.config
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 you have installed all nodes of your HAA cluster, confirm the successful configuration as follows:
- Navigate your browser 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 the installation to login.
- Select the nodes tab and verify that all installed nodes appear here 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 this database is created on port
10000
with the password provided at installation.
HAA Licensing
To add or update your High Availability Add-on license, follow these steps:
- Navigate your browser 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 the installation to login.
- 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 2 months ago