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

インストールの概要

注:

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

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

• クイック – 提供されているスクリプトをダウンロードして実行します。単一のデータセンター内に HAA を設定する場合に使用します。詳細については、「 クイック インストール」をご覧ください。
• advanced – クラスター DNS の構成、クラスターの作成とセットアップなど、いくつかの複雑な操作を実行する複数のデータセンター内に HAA を設定する場合に使用します。詳しくは、「 アクティブ/アクティブな Disaster Recovery のインストール」をご覧ください。

HAA のインストールを進める前に、ハードウェアおよびソフトウェア要件が満たされていることを確認してください。

注:

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

   yum install wget
   

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

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

      locale -alocalectl
      

      localectl
      

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

      $ 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 を正しい形式で入力するには、最初に以下を実行し、ヘルプ メニューに関連する OS の値をメモします。

   get-haa.sh -h
   

   サポートされている OS のリストについては、「ソフトウェア要件」をご覧ください。

   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 を正しい形式で入力するには、最初に以下を実行し、ヘルプ メニューに関連する OS の値をメモします。

   get-haa.sh -h
   

   サポートされている OS のリストについては、「ソフトウェア要件」をご覧ください。

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

注:

LoadBalancer.Redis.ConnectionString パラメーターでは、Redis クラスター ノードに IP アドレスまたは DNS レコードを使用できます。

ただし、運用環境では DNS レコードを使用した方がスケーラブルであるため、DNS レコードを推奨します。

詳しくは、「Configure cluster DNS」をご覧ください。

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. [保存] を選択します。

これで、HAA クラスターの準備ができたので、Windows インストーラーの説明に従って Orchestrator のインストールを続行できます。