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.

  詳細については、「クイック インストール」をご覧ください。

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

  詳しくは、「アクティブ/アクティブな Disaster Recovery のインストール」をご覧ください。

Before proceeding with your HAA installation, make sure that you meet the hardware and software requirements.

注: HAA には、Orchestrator とは別のライセンスが必要です。アクティブ/アクティブな Disaster Recovery のデプロイ モデルでは、2 つの HAA ライセンスが必要です。詳細については、UiPath までお問い合わせください。

前提条件

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

• root ユーザーであるか、sudo で root ユーザーへのアクセス権がある。
• ユーザー作成権限がある。
• 有効な SSL/TLS 証明書を持っている必要があります。証明書の更新方法については、Redis のドキュメントをご覧ください。
• ファイアウォール サービスを有効化している
  注:

  root 権限は、インストールとアップグレードにのみ必要です。HAA 管理者に、クラスター サービスを管理するためのエスカレートされた権限は不要です。

  HAA 管理者が実行する次のデーモンにケイパビリティ ビットが設定され、実行可能ファイルに対して操作に必要な最小限の特権が許可されます。

  /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. 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. HAA をインストールするすべてのノードで、このプロセスを繰り返します。

     英語が言語リストに追加されているかどうかを確認します。

     使用言語と文字セット (エンコード) によっては、インストール スクリプトの実行中に問題が発生する可能性があります。以下のように、英語が言語リストに追加されているかどうかをまず確認することをお勧めします。

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

        locale -alocalectl

        localectl

     2. Set English as the language and encoding for the current session, by running:

        $ export LANG="en_US.utf8"

クイック インストール

重要: HAA のクイック インストールに進む前に、すべてのノードが前提条件を満たしていることを確認してください。

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

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

1. ルート権限でプライマリ ノードに SSH 接続します。
2. HAA をダウンロードして展開するディレクトリを作成します。以下に例を示します。

   mkdir haa

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

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

   注: 詳しくは、「スクリプトのパラメーター」セクションをご覧ください。
4. get-haa.sh スクリプトを実行可能にします。

   chmod a+x get-haa.sh

5. プライマリ ノードをインストールします。必ず管理者アカウントのメール アドレスとパスワードを指定してください。一時的なメール アドレスを使用できます。ノードで実行されているオペレーティング システム (OS) も指定する必要があります。
   注: インストール コマンドの実行時に、使用する OS を正しい形式で入力するには、最初に get-haa.sh -h を実行して、ヘルプ メニューに表示される関連する OS の値をメモします。

   現在、設定可能な OS の値は、Rhel8、Rhel9、または UbuntuFocal です。

   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

   注:

   詳しくは、「スクリプトのパラメーター」セクションをご覧ください。

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

   chmod a+x get-haa.sh

6. セカンダリ ノードをインストールします。
   注: インストール コマンドの実行時に、使用する OS を正しい形式で入力するには、最初に get-haa.sh -h を実行して、ヘルプ メニューに表示される関連する OS の値をメモします。

   現在、設定可能な OS の値は、Rhel8、Rhel9、または UbuntuFocal です。

   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 スクリプトを実行する場合のみ)。 注: 選択したインストール パスをダブルチェックします。ある場所にインストールしたものを後から別の場所に移動することはできません。
--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" />

cluster_config.json を構成する

重要:

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

HAA を使用するように Automation Suite を設定するには、cluster_config.json ファイルの fabric.redis セクションを更新する必要があります。詳しくは、「High Availability Add-on の構成」をご覧ください。

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

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

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

   

   
   
2. インストール中に指定したユーザー名とパスワードを入力してログインします。
3. [ノード] タブを選択し、そこに表示されるすべてのインストール済みノードのステータスが OK であることを確認します。
   
   

   

   
   
4. [データベース] タブを選択し、表示される uipath-orchestrator データベースのステータスが OK であることを確認します。
5. マルチノードにデプロイする場合は、データベースの設定で複製が有効化されていて、2 つのノードでシャード数が 1 と表示されることを確認します。これによって、データベースを確実に 2 つのノードで複製することができます。
   注: 既定では、データベースは、インストール時に指定したパスワードで、ポート 10000 上に作成されます。

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

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

1. ブラウザーで、任意の HAA ノードの IP アドレスのポート 8443 に移動します。例: https://10.10.20.196:8443/HAA のログイン ページが表示されます。
2. インストール中に指定したユーザー名とパスワードを入力してログインします。
3. [設定] > [全般] タブを選択します。
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.