High Availability Add-on インストールガイド

最終更新日時 2024年8月22日

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

インストールの概要

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

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

クイック - 提供されているスクリプトをダウンロードして実行します。単一のデータセンター内に HAA を設定する場合に使用します。

詳細については、「クイックインストール」をご覧ください。
高度 - クラスターの 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 -asudo swapoff -a
```
2. 再起動時もこの変更を保持するために、etc/fstab ファイル内の swap パーティションを削除します。
3. wget パッケージをインストールします。必ずお使いの Linux ディストリビューションでサポートされているダウンロードコマンドを使用してください。たとえば、CentOS を使用する場合は、以下を実行します。
```
yum install wgetyum install wget
```
4. HAA をインストールするすべてのノードで、このプロセスを繰り返します。
  英語が言語リストに追加されているかどうかを確認します。
  使用言語と文字セット (エンコード) によっては、インストールスクリプトの実行中に問題が発生する可能性があります。以下のように、英語が言語リストに追加されているかどうかをまず確認することをお勧めします。
  1. 次のいずれかのコマンドを実行して、現在インストールされている locale に関する情報を表示します。
    locale -alocalectllocale -alocalectl
    localectllocalectl
  2. 現在のセッションの言語とエンコードを英語に設定するには、以下を実行します。
    $ export LANG="en_US.utf8"$ export LANG="en_US.utf8"

クイックインストール

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

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

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

ルート権限でプライマリノードに SSH 接続します。
HAA をダウンロードして展開するディレクトリを作成します。以下に例を示します。
```
mkdir haamkdir haa
```
get-haa.sh インストールスクリプトをダウンロードします。
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
注: 詳しくは、セクションをご覧ください。
get-haa.sh スクリプトを実行可能にします。
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
プライマリノードをインストールします。必ず管理者アカウントのメールアドレスとパスワードを指定してください。一時的なメールアドレスを使用できます。ノードで実行されているオペレーティングシステム (OS) も指定する必要があります。

注: インストールコマンドの実行時に、使用する OS を正しい形式で入力するには、最初に get-haa.sh -h を実行して、ヘルプメニューに表示される関連する OS の値をメモします。
現在、設定可能な OS の値は、Rhel8、Rhel9、または UbuntuFocal です。
```
sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreementsudo ./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 です。

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

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

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

ルート権限でセカンダリノードに SSH 接続します。
HAA をダウンロードして展開するディレクトリを作成します。以下に例を示します。
```
mkdir haamkdir haa
```
新しく作成したディレクトリに移動します。
```
cd /<path-to>/haa/cd /<path-to>/haa/
```
get-haa.sh インストールスクリプトをダウンロードします。
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
注: 詳しくは、セクションをご覧ください。
get-haa.sh スクリプトを実行可能にします。
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
セカンダリノードをインストールします。
注: インストールコマンドの実行時に、使用する 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-agreementsudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement
```
重要: プライマリノードの作成時に設定したメールアドレス、パスワード、および IP アドレスを指定してください。

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

HAA のインストールスクリプトを実行するときは、以下のパラメーターを使用できます。

パラメーター	説明
`-u`	HAA クラスター管理者のユーザー名。例: `-u documentation@uipath.com`
`-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" /><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 クラスターの全ノードのインストールが完了したら、以下の手順に従い、設定が適切に行われていることを確認します。

ブラウザーで、任意の HAA ノードの IP アドレスのポート 8443 に移動します (例 : https://10.10.20.196:8443/)。HAA のログインページが表示されます。
インストール中に指定したユーザー名とパスワードを入力してログインします。
[ノード] タブを選択し、そこに表示されるすべてのインストール済みノードのステータスが OK であることを確認します。
[データベース] タブを選択し、そこに表示される uipath-orchestrator データベースのステータスが OK であることを確認します。
マルチノードにデプロイする場合は、データベースの設定で複製が有効化されていて、2 つのノードでシャード数が 1 と表示されることを確認します。これによって、データベースを確実に 2 つのノードで複製することができます。

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

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

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

ブラウザーで、任意の HAA ノードの IP アドレスのポート 8443 に移動します。例: https://10.10.20.196:8443/HAA のログインページが表示されます。
インストール中に指定したユーザー名とパスワードを入力してログインします。
[設定] > [全般] タブを選択します。
[Cluster key] フィールドにライセンスキーを入力します。
[保存] をクリックします。