- Getting Started
- Requirements
- Best Practices
- Installation
- Updating
- Identity Server
- High Availability Add-on
Installation
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.
- HAA requires a separate license from Orchestrator. Contact UiPath for details.
- Active/Active Disaster Recovery deployment models require two HAA licenses.
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.
- 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
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
. - Install the
wget
package, used for downloading theRS
installation file, by running theyum install wget
command. - 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"
.
The following parameters are available when running the HAA installation script:
Parameter |
Decription |
---|---|
|
The username of the HAA cluster administrator. For example
-u documentation@uipath.com .
|
|
The password for the administration user, set when installing the primary node. For example
-p SuperSecret_Password .
|
|
The IP address of the primary node. When provided, a secondary (slave) node is installed. For example
-j 10.10.22.10 .
|
|
Indicate the path to the HAA installation directory (only when running the
install.sh script for advanced installation).
Note: Double-check the selected installation path. Moving an installation from one location to another post-install is not supported.
|
|
Indicate the path to the HAA configuration directory (only when running the
install.sh script for advanced installation).
|
|
Indicate the path to the HAA variables directory (only when running the
install.sh script for advanced installation).
|
|
Used to display the installation help guide. |
|
The license code for your HAA cluster. |
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" />
<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" />
After you have installed all nodes of your HAA cluster, confirm the successful configuration as follows:
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.