- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベストプラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バンドルに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn スナップショットを自動的にクリーンアップする方法
- NIC チェックサムオフロードを無効にする方法
- 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 メトリックが表示されない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドル ツールを使用する
- ログを確認する
手動: シングル ノードの評価プロファイルの要件とインストール
このページでは、シングルノード評価プロファイルの要件とインストール手順について説明します。
選択するデプロイ プロファイルに関係なく、Linux と Kubernetes の知識が必要です。Automation Suite のインストールと構成で問題が発生した場合は、UiPath プロフェッショナル サービスにお問い合わせください。
デプロイ プロファイルを選択する前に、「シングルノードおよびマルチノードのインストールにサポートされるユース ケース」をご覧ください。
インストール プロセスによって、ユーザーに代わって自己署名証明書が生成されます。これらの証明書は 90 日で有効期限が切れるので、インストールが完了したら速やかに、信頼された証明機関 (CA) によって署名された証明書に置き換える必要があります。証明書を更新しないと、90 日後にインストールが停止します。手順については、「証明書を管理する」をご覧ください。
Federal Information Processing Standard (FIPS) は、Automation Suite に対応していません。Automation Suite を実行しているサーバー上で、任意の時点で FIPS が有効化された場合、クラスターは失敗します。クラスター サーバーで FIPS が有効化されている場合、インストールがブロックされる問題がインストーラーで発生します。
デプロイ プロファイル |
前提条件 |
要件 |
構成 |
インストール |
---|---|---|---|---|
シングルノードの評価プロファイル |
ipcalc ツールをインストールした Linux マシン 1 台 (RHEL 8.6、8.8、または 8.9)
注:
|
| ||
| ||||
DNS | N/A | |||
TLS 1.2+ |
N/A | |||
IPv4 重要:
IPv6 はサポートされていません。 |
N/A |
N/A | ||
信頼できる TLS、トークン署名、および SQL 接続暗号化証明書 | N/A | |||
プロキシ サーバー (任意) | N/A | |||
Kerberos 認証 (任意) |
N/A |
RHEL kernel version kernel-4.18.0-477.10.1.el8_8 は、Automation Suite クラスターのインストールまたは管理を中断させる問題の影響を受けます。どの Automation Suite ノードも、インストール前またはインストール後にこのバージョンのカーネルを使用していないことを確認してください。以下のコマンドを実行するとカーネルのバージョンを更新できます。
dnf install -y kernel kernel-tools kernel-tools-libs
dnf install -y kernel kernel-tools kernel-tools-libs
- Automation Suite をインストールおよびデプロイするには、ルート権限が必要です。
ルート アクセスを必要とする特定のコンポーネントの詳細については、「root 権限の要件」をご覧ください。 -
Cilium が正常に機能するには、CAP_SYS_ADMIN権限が必要です。 これらのアクセス許可が付与されていることを確認してください。
- お使いのシステムでスキャン エージェントが実行されている場合、スキャン エージェントによって IP テーブルが変更されるために、インストールまたはランタイムが失敗する可能性があります。この問題を回避するには、スキャン エージェントを構成して、Automation Suite のインストールに干渉しないようにします。
- UiPath は、Automation Suite の要件を満たしている限り、特定のファイアウォールや開発者ツールの設定を規定していません。 UiPath の見解によると、外部ツールの数が限られていると、Automation Suite のスムーズな操作が妨げられる可能性があります。 このような問題が発生した場合は、関連するベンダーにお問い合わせください。 追加の指針については、「 Automation Suite の責任マトリクス」をご覧ください。
シングルノードの評価プロファイルを選択する場合は、完全な製品選択に対応する以下のハードウェア要件を満たす必要があります。個々の製品のハードウェア要件を確認するには、「要件算出ツール」をご覧ください。
一般的な要件
ハードウェア |
最小要件 |
---|---|
プロセッサ |
32 (v-)CPU/コア |
RAM |
64 GiB |
ノードごとのクラスター バイナリとステート ディスク |
256 GiB SSD 最小 IOPS: 1100 |
ブロック ストレージ |
512 GiB SSD 最小 IOPS: 1100 |
サーバー ノードの etcd ディスク |
16 GiB SSD 最小 IOPS: 240 |
UiPath バンドル ディスク (オフライン インストールの場合のみ、いずれかのサーバー ノード上で) |
512 GiB SSD 最小 IOPS: 1100 |
ObjectStore1 |
512 GiB SSD 最小 IOPS: 1100 |
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 ロボットの追加の推奨事項
シングルノードの評価環境では、追加の 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 に関する考慮事項」をご覧ください。
このセクションでは、Automation Suite を正常にデプロイするための最小ハードウェア要件を示します。デプロイの最小ハードウェア要件は、スイートの共有機能の要件と、インストールする個々の製品の要件を合計した値です。
以下の表に、スイートの共有機能の要件を示します。
CPU |
RAM | |
---|---|---|
共有されるスイート機能 |
9.5 (v-)CPU |
16.4 GiB |
以下の表に、個々の製品の要件を示します。
製品 |
CPU |
RAM |
---|---|---|
Action Center |
0.7 (v-)CPU |
2.1 GiB |
AI Center |
2 (v-)CPU |
6.5 GiB |
Apps (アプリ) |
2.8 (v-)CPU |
7.2 GiB |
Automation Hub |
0.5 (v-)CPU |
1.4 GiB |
Automation Ops |
0.2 (v-)CPU |
0.7 GiB |
Automation Suite ロボット |
0.5 (v-)CPU |
0.7 GiB |
Data Service |
0.2 (v-)CPU |
0.5 GiB |
Document Understanding |
3.2 (v-)CPU |
4 GiB |
Insights |
0.3 (v-)CPU |
1.7 GiB |
Orchestrator |
1 (v-)CPU |
2.6 GiB |
Process Mining |
2.2 (v-)CPU |
3 GiB |
Task Mining |
4 (v-)CPU |
5 GiB |
Test Manager |
0.5 (v-)CPU |
1 GiB |
Automation Suite の手動インストールを開始する前に、以下の要件を満たしていることを確認する必要があります。
- RHEL のサブスクリプションがある。
- BaseOS リポジトリと AppStream リポジトリを有効化している
- 必要な RPM パッケージをインストールしている (必要な RPM パッケージのインストールはユーザーの責任です)。
以前のバージョンの Automation Suite からアップグレードする場合、RPM パッケージはインストール済みです。
以下の表に、必要な RPM パッケージのリストを示します。
RPM パッケージ |
説明 |
---|---|
|
インストールのためにノードに必要です。 |
|
準備状況の確認を実行するためにノードに必要です。 |
|
Ansible が必要な
uipathctl.sh の機能を実行するためにオーケストレーション ノードに必要です。
|
|
オフライン インストールでのみ必要です。 |
RHEL 8.3 には、既定で Podman 1.6 が含まれます。これにより、インストールの問題が発生する可能性があります。これを防ぐには、Podman をバージョン 3.2.3 に更新します。
RHEL 8.4 以降では、必要な RPM パッケージが BaseOS リポジトリと AppStream リポジトリに既定で格納されています。
必要な RPM パッケージのインストール方法の詳細については、「マシンを構成する」をご覧ください。