High Availability Add-on をインストールする

インストールの概要

注:

Orchestrator の古いバージョンとの対応性はサポートされますが、最新の HAA バージョンに更新することをお勧めします。

Orchestrator インスタンス用の High Availability Add-on (HAA) をインストールするには、次の 2 つの方法があります。

• quick – by downloading and executing a provided script; used when you want to set up HAA inside a single data center. For details, refer to 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 data centers. For details, refer to 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.

前提条件

以下の前提条件は、クイック インストールと高度なインストールの両方で同じです。HAA のインストールを開始する前に、次の点を確認してください。

• root ユーザーであるか、sudo で root ユーザーへのアクセス権がある。
• ユーザー作成権限がある。
• ensure that you have a valid SSL/TLS certificate. Refer to Redis documentation for instructions on how to update your certificates;
• ファイアウォール サービスを有効化している

注:

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

したがって、HAA 管理者は特権を付与されなくてもこれらのサービスを実行できます。

1. swap を無効化します。

   sudo swapoff -a
   

2. 再起動時もこの変更を保持するために、etc/fstab ファイル内の swap パーティションを削除します。

3. wget パッケージをインストールします。必ずお使いの Linux ディストリビューションでサポートされているダウンロード コマンドを使用してください。たとえば、CentOS を使用する場合は、以下を実行します。

   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. 次のいずれかのコマンドを実行して、現在インストールされている locale に関する情報を表示します。

      locale -alocalectl
      

      localectl
      

   2. 現在のセッションの言語とエンコードを英語に設定するには、以下を実行します。

      $ export LANG="en_US.utf8"
      

Quick installation

重要:

Before proceeding with the quick installation of HAA, make sure all your nodes meet the prerequisites.

プライマリ ノードをインストールする

プライマリ ノードに HAA をインストールするには、次の手順を実行します。

1. ルート権限でプライマリ ノードに SSH 接続します。

2. HAA をダウンロードして展開するディレクトリを作成します。以下に例を示します。

   mkdir haa
   

3. get-haa.sh インストール スクリプトをダウンロードします。

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

   注:

   Refer to the Script parameters section for more details.

4. get-haa.sh スクリプトを実行可能にします。

   chmod a+x get-haa.sh
   

5. プライマリ ノードをインストールします。必ず管理者アカウントのメール アドレスとパスワードを指定してください。一時的なメール アドレスを使用できます。ノードで実行されているオペレーティング システム (OS) も指定する必要があります。

   注:

   To enter your OS in the correct format when running the installation command, run the following first and note the relevant OS value in the help menu:

   get-haa.sh -h
   

   For the list of suppoted OSs, refer to Software requirements.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreement
   

重要:

ユーザーが設定した場所に HAA をインストールするには、詳細設定のための install-haa.sh スクリプトを実行します (これによってクラスターは作成されません)。すべての場所は異なる必要がありますのでご注意ください。以下に例を示します。

sudo ./install-haa.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath

選択したインストール パスをダブルチェックします。ある場所にインストールしたものを後から別の場所に移動することはできません。

セカンダリ ノードをインストールする

プライマリ ノードのインストール後、各セカンダリ ノードで次の手順を実行します。

1. ルート権限でセカンダリ ノードに SSH 接続します。

2. HAA をダウンロードして展開するディレクトリを作成します。以下に例を示します。

   mkdir haa
   

3. 新しく作成したディレクトリに移動します。

   cd /<path-to>/haa/
   

4. get-haa.sh インストール スクリプトをダウンロードします。

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

   注:

   Refer to the Script parameters section for more details.

5. get-haa.sh スクリプトを実行可能にします。

   chmod a+x get-haa.sh
   

6. セカンダリ ノードをインストールします。

   注:

   To enter your OS in the correct format when running the installation command, run the following first and note the relevant OS value in the help menu:

   get-haa.sh -h
   

   For the list of suppoted OSs, refer to Software requirements.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement
   

   重要:

   プライマリ ノードの作成時に設定したメール アドレス、パスワード、および IP アドレスを指定してください。

スクリプトのパラメーター

以下の表で、HAA のインストール スクリプトを実行する際に利用可能なパラメーターを説明します。

パラメーター	説明
-u	HAA クラスター管理者のユーザー名。 例: -u [e-mail]
-p	プライマリ ノードのインストール時に設定される管理ユーザーのパスワード。 例: -p SuperSecret_Password
-j	プライマリ ノードの IP アドレス。指定すると、セカンダリ (スレーブ) ノードがインストールされます。 例: -j 10.10.22.10
--install-dir	HAA インストール ディレクトリのパスを指定します (詳細インストールのための install-haa.sh スクリプトを実行する場合のみ)。 Make sure to double-check the selected installation path. Moving an installation from one location to another post-install is not supported.
--config-dir	HAA 構成ディレクトリのパスを指定します (詳細インストールのための install-haa.sh スクリプトを実行する場合のみ)。
--var-dir	HAA 変数ディレクトリのパスを指定します (詳細インストールのための install-haa.sh スクリプトを実行する場合のみ)。
-h	インストールのヘルプ ガイドの表示に使用されます。
-l	HAA クラスターのライセンス コードです。ライセンスの先頭と末尾に --- LICENSE START --- または --- LICENSE END --- を含めずに、また new line の文字を使用せずにライセンスを入力してください。
--accept-license-agreement	UiPath のライセンス契約に同意します。
--offline	オフライン インストールの場合に使用します。インストール スクリプトと同じく、パッケージが現在のフォルダーに存在するものとみなされます。パッケージのリンクは get-haa.sh スクリプトの中にあります。

UiPath.Orchestrator.dll.config を構成する

重要:

この手順が必要になるのは、スタンドアロンの Orchestrator に HAA を使用する場合のみです。

HAA を使用できるようにスタンドアロン Orchestrator を設定し、LoadBalancer.UseRedis および LoadBalancer.Redis.ConnectionString パラメーターを使用して、Orchestrator の構成ファイルにすべての HAA ノードを追加する必要があります。以下に例を示します。

<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,abortConnect=false" />

注:

You can use either IP addresses or DNS records for the Redis cluster nodes in the LoadBalancer.Redis.ConnectionString parameter.

However, for production environments, using DNS records is more scalable and recommended.

For more details, refer to Configure cluster DNS.

cluster_config.json を構成する

重要:

この手順が必要になるのは、Automation Suite に HAA を使用する場合のみです。

You must configure Automation Suite to use HAA by updating the fabric.redis section in the cluster_config.json file. For more details, refer to High Availability Add-on configuration.

クラスター インストールの検証

HAA クラスターの全ノードのインストールが完了したら、以下の手順に従い、設定が適切に行われていることを確認します。

1. ブラウザーで、任意の HAA ノードの IP アドレスのポート 8443 に移動します (例 : https://10.10.20.196:8443/)。HAA のログイン ページが表示されます。

   

2. インストール中に指定したユーザー名とパスワードを入力してログインします。

3. Select the nodes tab and verify that all installed nodes are displayed with a status of OK.

   

4. Select the databases tab and confirm that the uipath-orchestrator database appears with a status of OK.

5. マルチノードにデプロイする場合は、データベースの設定で複製が有効化されていて、2 つのノードでシャード数が 1 と表示されることを確認します。これによって、データベースを確実に 2 つのノードで複製することができます。

   注:

   既定では、データベースは、インストール時に指定したパスワードで、ポート 10000 上に作成されます。

HAA のライセンスを有効化する

High Availability Add-on ライセンスを追加または更新するには、次の手順を実行します。

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. インストール中に指定したユーザー名とパスワードを入力してログインします。

3. Select Settings > General tab.

4. [Cluster key] フィールドにライセンス キーを入力します。

5. [保存] を選択します。

Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described in the The Windows Installer.