- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn のスナップショットを自動的にクリーンアップする方法
- TX チェックサム オフロードを無効化する方法
- TLS 1.2 で弱い暗号に対処する方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- プロキシ設定がある場合に Automation Hub と Apps を起動できない
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- 移行後に認証が機能しない
- Kinit: Cannot find KDC for realm <AD Domain> while getting initial credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- 無効なステータス コードが原因で GSSAPI 操作が失敗した
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- アカウントが無効なため AD ユーザーのログインに失敗した
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初回インストール後に ArgoCD が進行中ステートになる
- Unexpected inconsistency; run fsck manually
- MongoDB ポッドが CrashLoopBackOff になるか、削除後に PVC プロビジョニングの保留中になる
- MongoDB ポッドを 4.4.4-ent から 5.0.7-ent にアップグレードできない
- クラスターの復元またはロールバック後にサービスが異常になる
- Init:0/X でポッドがスタックする
- Prometheus が CrashloopBackoff ステートにあり、メモリ不足 (OOM) エラーを伴う
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- プロキシ環境でポッドが FQDN と通信できない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドルを使用する
- ログを確認する
Automation Suite インストール ガイド
ハードウェアおよびソフトウェアの要件
Automation Suite のデプロイで使用される主要な概念の詳細については、「用語集」をご覧ください。
既定のインストール エクスペリエンスでは、インストールする製品群を 2 つの選択肢から選びます。
- Complete (All products) – Automation Suite で利用可能なすべての製品をインストールします。詳しくは、「Automation Suite 製品」をご覧ください。
-
Select products – 関心のある製品のみを選択してインストールできます。ただし、インストーラーによって製品間の依存関係が考慮されます。つまり、ある製品を使うために別の製品をインストールする必要がある場合は、その製品を両方ともインストールする必要があります。詳しくは、「製品間の依存関係」をご覧ください。
Automation Suite をシングルノードの評価モードまたはマルチノードの HA 対応の運用モードでインストールできます。前提条件は 2 つのプロファイルでほぼ同じですが、マルチノードの HA 対応の運用モードでは追加のリソースが必要です。
デプロイが開始されると、デプロイ プロファイルを切り替えたり、アップグレードできなくなります。デプロイ プロファイルを選択する前に、「シングルノードおよびマルチノードのインストールにサポートされるユース ケース」をご覧ください。
デプロイ プロファイル |
前提条件 |
インストール |
---|---|---|
シングルノード プロファイル: 評価およびデモのシナリオでのみサポートされ、運用環境のデプロイではサポートされません。 |
サポートされている RHEL バージョンと ipcalc ツールがインストールされた Linux マシン 1 台。 Automation Suite のバージョンとの RHEL の相互運用性について詳しくは、「 RHEL の相互運用性マトリクス」をご覧ください。
注:
|
|
| ||
DNS | ||
TLS 1.2+ | ||
IPv4 重要:
IPv6 はサポートされていません。 | ||
信頼できる TLS、トークン署名、および SQL 接続暗号化証明書 | ||
プロキシ サーバー (任意) | ||
Kerberos 認証 (任意) | ||
マルチノードの HA 対応プロファイル: 運用環境のデプロイでサポートされる唯一の構成です。 |
サポートされている RHEL バージョンと ipcalc ツールがインストールされた Linux マシンが 3 台以上。 Automation Suite のバージョンとの RHEL の相互運用性について詳しくは、「 RHEL の相互運用性マトリクス」をご覧ください。
注:
|
|
| ||
DNS | ||
TLS 1.2+ | ||
IPv4 重要:
IPv6 はサポートされていません。 | ||
信頼できる TLS、トークン署名、および SQL 接続暗号化証明書 | ||
ロード バランサー | ||
プロキシ サーバー (任意) | ||
Kerberos 認証 (任意) |
- Automation Suite をインストールおよびデプロイするには、ルート権限が必要です。
ルート アクセスを必要とする特定のコンポーネントの詳細については、「root 権限の要件」をご覧ください。 -
Cilium が正常に機能するには、CAP_SYS_ADMIN 権限が必要です。これらの権限が付与されていることを確認してください。
- お使いのシステムでスキャン エージェントが実行されている場合、スキャン エージェントによって IP テーブルが変更されるために、インストールまたはランタイムが失敗する可能性があります。この問題を回避するには、スキャン エージェントを構成して、Automation Suite のインストールに干渉しないようにします。
-
UiPath は、Automation Suite の要件を満たしている限り、特定のファイアウォールや開発者ツールの構成を指示しません。UiPath の見解では、外部ツールの数が限られていても、Automation Suite のスムーズな操作が妨げられる可能性があります。このような問題が発生した場合は、関連するベンダーにお問い合わせください。追加の指針については、「責任のマトリクス」をご覧ください。
次のセクションでは、完全な製品選択と個々の製品の両方のハードウェア要件を示します。
Federal Information Processing Standard (FIPS) は、Automation Suite に対応していません。Automation Suite を実行しているサーバー上で、任意の時点で FIPS が有効化された場合、クラスターは失敗します。クラスター サーバーで FIPS が有効化されている場合、インストールがブロックされる問題がインストーラーで発生します。
最小のハードウェア要件では、ノードの障害からデプロイを保護できません。
マルチノードの HA 対応の運用プロファイルは、1 つのノードの障害に対してのみ回復性があります。つまり、失うことができるサーバー ノードは 1 つだけです。この制限は、エージェント ノードには適用されません。クラスター全体の容量が十分に利用可能な限り、エージェント ノードをいくら失っても、ダウンタイムなしでクラスターを使用し続けることができます。
「高度なインストール」の手順に従って、サーバー ノードの障害許容度を向上できます。
次のセクションでは、完全な製品選択のハードウェア要件について説明します。
一般的な要件
すべての製品で使用するハードウェア |
シングルノードの最小要件 |
マルチノードの最小要件 |
---|---|---|
クラスターあたりのプロセッサ1 |
32 (v-)CPU/コア |
96 (v-)CPU/コア |
ノードあたりの最小プロセッサー数 |
N/A |
8 (v-)CPU/コア |
RAM |
64 GiB |
192 GiB |
ノードあたりの最小 RAM |
N/A |
16 GiB |
各ノードのクラスター バイナリとステート ディスク2 |
256 GiB SSD 最小 IOPS: 1100 |
256 GiB SSD 最小 IOPS: 1100 |
データ ディスク3 |
512 GiB SSD 最小 IOPS: 1100 |
512 GiB SSD 最小 IOPS: 1100 |
サーバー ノードの etcd ディスク |
16 GiB SSD 最小 IOPS: 240 |
16 GiB SSD 最小 IOPS: 240 |
UiPath バンドル ディスク (オフライン インストールの場合のみ、いずれかのサーバー ノード上で) |
512 GiB SSD 最小 IOPS: 1100 |
512 GiB SSD 最小 IOPS: 1100 |
ObjectStore4 |
512 GiB SSD 最小 IOPS: 1100 |
512 GiB SSD 最小 IOPS: 1100 |
1UiPath Apps を使用している場合は、CPU が AVX をサポートしている必要があります。
2 クラスター ディスクの容量は、AI Center の ML スキルやトレーニング ストレージの要件によっては増やさなければならない場合があります。
3 データ ディスクはブロック ストアとして使用されます。
4 これはクラスター内の ObjectStore を指し、外部 ObjectStore を使用する場合は適用されません。
Automation Suite をシングルノードの評価モードでインストールする際に、32 (v-)CPU/コア、64 GiB の RAM を搭載したマシンがない場合は、最小で 8 (v-)CPU/コアと 16 GiB の RAM を搭載したマシンを利用できます。詳しくは、「要件算出ツール」をご覧ください。
このオプションを選択する場合は、マルチノードのインストールと構成の手順に従ってください。
可能な場合は外部 ObjectStore を使用することをお勧めします。ObjectStore をクラスターから独立してスケーリングできるので、安定性が向上します。次の ObjectStore オプションがサポートされています。
- Azure Storage アカウント
- AWS S3 のストレージ バケット
- S3 互換のストレージ バケット
Task Mining の追加要件
Task Mining には、次の要件を満たす追加のエージェント ノードが必要です。
ハードウェア |
最小要件 |
---|---|
プロセッサ |
20 (v-)CPU/コア |
RAM |
60 GiB |
クラスター バイナリとステート ディスク |
256 GiB SSD 最小 IOPS: 1100 |
データ ディスク |
N/A |
Automation Suite ロボットの追加要件
マルチノードの HA 対応の運用環境では、Automation Suite ロボットに追加のエージェント ノードが必要です。シングルノードの評価環境では、追加の Automation Suite ロボット ノードは任意です。
Automation Suite ロボット ノードのハードウェア要件は、リソースの使用方法によって異なります。追加のエージェント ノードの要件に加えて、パッケージのキャッシュを有効化するために 10 GiB 以上の容量も必要です。
次のセクションでは、Automation Suite ロボット ノードで必要なハードウェアの量に影響する要因について説明します。
ロボットのサイズ
Size |
CPU |
メモリ |
ストレージ |
---|---|---|---|
小 |
0.5 |
1 GiB |
1 GiB |
標準 |
1 |
2 GiB |
2 GiB |
中 |
2 |
4 GiB |
4 GiB |
大 |
6 |
10 GiB |
10 GiB |
エージェント ノードのサイズ
Automation Suite ロボット エージェント ノードのリソースは、同時に実行できるジョブの数に影響します。その理由は、CPU コアの数と RAM の容量が、ジョブの CPU/メモリ要件で除算されるためです。
たとえば、16 CPU と 32 GiB の RAM を搭載したノードは、次のいずれかを実行できます。
- 32 個の小型のジョブ
- 16 個の標準ジョブ
- 8 個の中型のジョブ
- 2 個の大型のジョブ
複数のジョブ サイズを混在できるため、特定の時点において、同じノードで次のようなジョブの組み合わせを実行できます。
- 10 個の小型のジョブ (5 CPU と 10 GiB のメモリを消費)
- 4 個の標準ジョブ (4 CPU と 8 GiB のメモリを消費)
- 3 個の中型のジョブ (6 CPU と 12 GiB のメモリを消費)
Kubernetes のリソース消費量
ノードは Kubernetes クラスターに属しているため、サーバー上に存在する Kubernetes エージェント (kubelet) は少量のリソースを消費します。UiPath の測定結果によると、Kubelet が消費するリソースは以下のとおりです。
- 0.6 CPU
- 0.4 GiB RAM
前述のノードと同様のノードでは、実際の容量は約 15.4 CPU と 31.6 GiB の RAM になります。
マシン サイズの自動選択
すべてのクロスプラットフォーム プロセスでは、[Automation Suite ロボット] のオプションが既定で [自動] に設定されています。この設定では、サーバーレス ロボットを使用してプロセスを実行するのに適したマシン サイズが選択されます。
サイズの自動選択にあたっては、以下の表に記載された基準が順番に評価されます。ある基準が満たされた時点で、その基準に対応するマシン サイズが選択され、残りの基準は評価されません。
順序 |
基準 |
マシン サイズ |
---|---|---|
1 |
リモート デバッグのジョブである |
中 |
2 |
プロセスが UI Automation に依存している または プロセスが UiPath Document Understanding アクティビティに依存している |
標準 |
3 |
その他の無人プロセス |
小 |
Document Understanding の追加の推奨事項
パフォーマンスを向上させるには、GPU がサポートされた追加のエージェント ノードに Document Understanding をインストールできます。ただし、Document Understanding は GPU ノードがなくても完全に機能します。実際には、Document Understanding はすべての抽出および分類タスクに CPU 仮想マシンを使用しますが、OCR には GPU 仮想マシンを使用することを強くお勧めします。Document Understanding フレームワーク内での CPU/GPU の使用方法の詳細については、こちらをご覧ください。
GPU サポートのある追加のノードを使用する場合、次の要件を満たす必要があります。
ハードウェア |
最小要件 |
---|---|
プロセッサ |
8 (v-)CPU/コア |
RAM |
52 GiB |
クラスター バイナリとステート ディスク |
256 GiB SSD 最小 IOPS: 1100 |
データ ディスク |
N/A |
GPU RAM |
11 GiB |
詳しくは、「AI Center に関する考慮事項」をご覧ください。
UiPath Apps に関するその他の推奨事項
UiPath Apps を使用している場合は、CPU が AVX をサポートしている必要があります。詳しくは、MongoDB の公式ドキュメントをご覧ください。
このセクションでは、Automation Suite を正常にデプロイするための最小ハードウェア要件を示します。デプロイの最小ハードウェア要件は、スイートの共有機能の要件と、インストールする個々の製品の要件を合計した値です。
以下の表に、スイートの共有機能の要件を示します。
レイヤー |
シングルノードの評価プロファイル |
マルチノードの高可用性対応の運用環境モード | ||
---|---|---|---|---|
CPU |
RAM |
CPU |
RAM | |
共有されるスイート機能 |
9.5 (v-)CPU |
16.4 GiB |
40 (v-)CPU |
47.6 GiB |
以下の表に、個々の製品の要件を示します。
製品 |
シングル ノードの評価モード |
マルチノードの高可用性対応の運用環境モード | ||
---|---|---|---|---|
CPU |
RAM |
CPU |
RAM | |
Action Center |
0.7 (v-)CPU |
2.1 GiB |
2 (v-)CPU |
4.7 GiB |
AI Center |
2 (v-)CPU |
6.5 GiB |
5.5 (v-)CPU |
14 GiB |
Apps (アプリ) |
2.8 (v-)CPU |
7.2 GiB |
7.25 (v-)CPU |
18.5 GiB |
Automation Hub |
0.5 (v-)CPU |
1.4 GiB |
2 (v-)CPU |
3.5 GiB |
Automation Ops |
0.2 (v-)CPU |
0.7 GiB |
1 (v-)CPU |
1.7 GiB |
Automation Suite ロボット |
0.5 (v-)CPU |
0.7 GiB |
1 (v-)CPU |
1.5 GiB |
Data Service |
0.2 (v-)CPU |
0.5 GiB |
0.5 (v-)CPU |
1 GiB |
Document Understanding |
3.2 (v-)CPU |
4 GiB |
6.7 (v-)CPU |
8.6 GiB |
Insights |
0.3 (v-)CPU |
1.7 GiB |
1.5 (v-)CPU |
5 GiB |
Orchestrator1 |
1 (v-)CPU |
2.6 GiB |
3.5 (v-)CPU |
7.2 GiB |
Process Mining |
2.2 (v-)CPU |
12 GiB |
5.1 (v-)CPU |
24 GiB |
Task Mining |
4 (v-)CPU |
5 GiB |
8.4 (v-)CPU |
10 GiB |
Test Manager |
0.5 (v-)CPU |
1 GiB |
1 (v-)CPU |
2 GiB |
Automation Suite のインストールを開始する前に、以下の要件を満たしていることを確認する必要があります。
- RHEL のサブスクリプションがある。
- BaseOS リポジトリと AppStream リポジトリを有効化している
- 必要な RPM パッケージがインストールされている。
以下の表に、必要な RPM パッケージのリストを示します。
RPM パッケージ |
説明 |
---|---|
|
インストールのためにノードに必要です。 |
|
準備状況の確認を実行するためにノードに必要です。 |
|
Ansible が必要な
uipathctl.sh の機能を実行するためにオーケストレーション ノードに必要です。
|
|
オフライン インストールでのみ必要です。 |
RHEL 8.4 以降では、必要な RPM パッケージが BaseOS リポジトリと AppStream リポジトリに既定で格納されています。
Automation Suite を手動でクリーン インストールする場合は、RPM パッケージの要件を満たしていることをユーザーが確認する必要があります。この場合、必要な RPM パッケージのインストールはユーザーの責任です。
以前のバージョンの Automation Suite からアップグレードする場合、RPM パッケージはインストール済みです。
RPM パッケージをインストールおよび検証するために使用できるツールについて詳しくは、以下をご覧ください。
インストールには、前提条件として外部 SQL Server が必要です。Microsoft SQL Server 2016、2017、2019、2022 の Standard および Enterprise エディションがサポートされています。
Microsoft SQL Server データベース エンジンが要件を満たしている限り、追加の Microsoft SQL プラットフォーム (Azure SQL Database や Azure SQL Managed Instance など) および Amazon Relational Database Service もサポートされます。
個々の製品サポートの内容は異なります。
デプロイを計画している各製品について、以下のことが必要です。
- 製品で必要とされる SQL Server のサポート バージョンを確認する
- 製品で必要とされる SQL Server 構成の前提条件 (SQL Server のユーザー権限を含む) を適用する
製品固有の SQL Server の要件の詳細については、シングルノードの評価プロファイルの SQL Server 構成と、マルチノードの高可用性対応の運用環境プロファイルの SQL Server 構成を参照してください。
Microsoft SQL Server の一般的な最小ハードウェア要件は次のとおりです。
- 8 (v-)CPU
- 32 GiB RAM
- 256 GiB SSD
ここに示す最小要件は一般的な指針であり、運用環境のデプロイにおいて信頼できる動作を保証するものではありません。信頼性のある動作に求められるハードウェア要件を決定するには、要件算出が必要です。
バックアップを有効化するには、外部 NFS サーバーが必要です。Automation Suite は Linux の NFSv4 をサポートしています。
NFS サーバーの一般的な最小ハードウェア要件は次のとおりです。
CPU |
RAM |
ディスク |
---|---|---|
4 (v-)CPU |
8 GiB |
2 TiB の SSD (1100 IOPS) |
以下の表に、Automation Suite の各バージョンでサポートされている RHEL のバージョンを示します。
Automation Suite バージョン |
RHEL のサポート対象バージョン |
---|---|
2022.10.14 | 8.6, 8.8, 8.9, 8.10, 9.2, 9.4 |
2022.10.13 |
8.6, 8.8, 8.9, 8.10, 9.2 |
2022.10.12 |
8.6、8.8、8.9 |
2022.10.11 |
8.6、8.8、8.9 |
2022.10.10 |
8.6、8.8、8.9 |
2022.10.9 |
8.6, 8.8 |
2022.10.8 |
8.6, 8.8 |
2022.10.7 |
8.6, 8.8 |
2022.10.6 |
8.6 |
2022.10.5 | 8.6 |
2022.10.4 | 8.6 |
2022.10.3 | 8.6 |
2022.10.2 | 8.6 |
2022.10.1 | 8.6 |
2022.10.0 | 8.6 |