- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- 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 サポート バンドルを使用する
- ログを確認する
用語
To find out more about the core concepts used in an Automation Suite deployment, see Glossary.
製品選択
既定のインストール エクスペリエンスでは、インストールする製品群を 2 つの選択肢から選びます。
-
Complete (All products) – Install the complete list of products available in Automation Suite. For details, see Automation Suite products.
-
Select products – Allows you to select and install only the products you are interested in. Note, however, that the installer takes the cross-product dependencies into consideration. That means that if a product requires the installation of another product, you must install both of them. For details, refer to Automation Suite products.
注:You can enable additional products later in the same deployment at any point in time, after the initial installation, without having to reinstall. For details, see Managing products.
We recommend validating the hardware requirements based on expected usage and ensuring the deployment has enough capacity before adding additional products. For details, see Capacity planning.
デプロイ プロファイルを選択する
Automation Suite をシングルノードの評価モードまたはマルチノードの HA 対応の運用モードでインストールできます。前提条件は 2 つのプロファイルでほぼ同じですが、マルチノードの HA 対応の運用モードでは追加のリソースが必要です。
Once the deployment starts, you cannot switch or upgrade from one deployment profile to another. Before choosing your deployment profile, see Supported use cases for single-node and multi-node installations.
選択するデプロイ プロファイルに関係なく、Linux と Kubernetes の知識が必要です。Automation Suite のインストールと構成で問題が発生した場合は、UiPath® プロフェッショナル サービスにお問い合わせください。
デプロイ プロファイルの一覧
| デプロイ プロファイル | 前提条件 | インストール |
|---|---|---|
|
Single-node profile: supported only for evaluation and demo scenarios, not for production deployments |
One Linux machine with supported RHEL version and ipcalc tool installed. For details about RHEL compatibility with Automation Suite versions, see RHEL compatibily matrix.
|
|
| ||
|
DNS | ||
|
TLS 1.2+ | ||
|
IPv4 IPv6 はサポートされていません。 | ||
|
信頼できる TLS、トークン署名、および SQL 接続暗号化証明書 | ||
|
プロキシ サーバー (任意) | ||
|
Kerberos 認証 (任意) | ||
|
Multi-node HA-ready profile: the only configuration supported for production deployments |
Minimum 3 Linux machines with supported RHEL version and ipcalc tool installed. For details about RHEL compatibility with Automation Suite versions, see RHEL compatibily matrix.
|
|
| ||
|
DNS | ||
|
TLS 1.2+ | ||
|
IPv4 IPv6 はサポートされていません。 | ||
|
信頼できる TLS、トークン署名、および SQL 接続暗号化証明書 | ||
|
ロード バランサー | ||
|
プロキシ サーバー (任意) | ||
|
Kerberos 認証 (任意) |
- You need root permission to install and deploy Automation Suite. For more on the specific components that require root access, see Root privileges requirement.
- Cilium が正常に機能するには、CAP_SYS_ADMIN 権限が必要です。これらの権限が付与されていることを確認してください。
- お使いのシステムでスキャン エージェントが実行されている場合、スキャン エージェントによって IP テーブルが変更されるために、インストールまたはランタイムが失敗する可能性があります。この問題を回避するには、スキャン エージェントを構成して、Automation Suite のインストールに干渉しないようにします。
- UiPath does not prescribe specific firewall or developer tool configurations as long as the Automation Suite requirements are met. Based on our observations, a limited number of external tools can interfere with the smooth operation of Automation Suite. If such issues arise, contact the relevant vendor for help. For additional guidance, see the Automation Suite responsibility matrix.
- インストールで発生する可能性のある問題を回避するには、デプロイで使用するすべてのノードが同じタイム ゾーンに設定されていることを確認します。
ハードウェア要件
次のセクションでは、完全な製品選択と個々の製品の両方のハードウェア要件を示します。
完全な製品選択: ハードウェア要件
Federal Information Processing Standard (FIPS) は、Automation Suite に対応していません。Automation Suite を実行しているサーバー上で、任意の時点で FIPS が有効化された場合、クラスターは失敗します。クラスター サーバーで FIPS が有効化されている場合、インストールがブロックされる問題がインストーラーで発生します。
最小のハードウェア要件では、ノードの障害からデプロイを保護できません。
マルチノードの HA 対応の運用プロファイルは、1 つのノードの障害に対してのみ回復性があります。つまり、失うことができるサーバー ノードは 1 つだけです。この制限は、エージェント ノードには適用されません。クラスター全体の容量が十分に利用可能な限り、エージェント ノードをいくら失っても、ダウンタイムなしでクラスターを使用し続けることができます。
You can increase the server node tolerance to failure by following the instructions in Advanced installation experience.
次のセクションでは、完全な製品選択のハードウェア要件について説明します。
一般的な要件
| すべての製品で使用するハードウェア | シングルノードの最小要件 | マルチノードの最小要件 |
|---|---|---|
| Processor1 per cluster | 32 (v-)CPU/コア | 96 (v-)CPU/コア |
| ノードあたりの最小プロセッサー数 | N/A | 8 (v-)CPU/コア |
| RAM | 64 GiB | 192 GiB |
| ノードあたりの最小 RAM | N/A | 16 GiB |
| Cluster binaries and state disk for each node2 | 256 GiB SSD 最小 IOPS: 1100 | 256 GiB SSD 最小 IOPS: 1100 |
| Data disk3 | 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 |
1 If you are using UiPath Apps, your CPU must have AVX support.
2 The cluster disks capacity may need to be increased based on your AI Center ML skills and training storage requirements.
3 The data disk is used as a block store.
4 This refers to the in-cluster objectstore and is not applicable if you use external objectstore.
If you install Automation Suite in single-node evaluation mode, and you do not have a machine with 32 (v-)CPU/cores and 64 GiB of RAM, you can bring machines with a minimum of 8 (v-)CPU/cores and 16 GiB of RAM. For more details, see Capacity calculator.
このオプションを選択する場合は、マルチノードのインストールと構成の手順に従ってください。
可能な場合は外部 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 ロボット ノードは任意です。
The hardware requirements for the Automation Suite Robots node depend on the way you plan to use your resources. In addition to the additional agent node requirements, you also need a minimum of 10 GiB to enable package caching.
次のセクションでは、Automation Suite ロボット ノードで必要なハードウェアの量に影響する要因について説明します。
ロボットのサイズ
次の表に、すべてのロボット サイズに必要な CPU、メモリ、およびストレージを示します。
| 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 に依存している または Process depends on the UiPath Document Understanding activities | 標準 |
| 3 | その他の無人プロセス | 小 |
Document Understanding の追加の推奨事項
For increased performance, you can install Document Understanding on an additional agent node with GPU support. Note, however, that Document Understanding is fully functional without the GPU node. Actually, Document Understanding uses CPU VMs for all its extraction and classification tasks, while for OCR we strongly recommend the usage of a GPU VM. Here you can find more information about the CPU/GPU usage within the Document Understand framework.
GPU サポートのある追加のノードを使用する場合、次の要件を満たす必要があります。
| ハードウェア | 最小要件 |
|---|---|
| プロセッサ | 8 (v-)CPU/コア |
| RAM | 52 GiB |
| クラスター バイナリとステート ディスク | 256 GiB SSD 最小 IOPS: 1100 |
| データ ディスク | N/A |
| GPU RAM | 11 GiB |
For more details, see AI Center considerations.
UiPath Apps に関するその他の推奨事項
If you are using UiPath Apps, your CPU must have AVX support. For more information, check the official MongoDB documentation.
個々の製品: ハードウェア要件
このセクションでは、Automation Suite を正常にデプロイするための最小ハードウェア要件を示します。デプロイの最小ハードウェア要件は、スイートの共有機能の要件と、インストールする個々の製品の要件を合計した値です。
このセクションに示す最小ハードウェア要件を満たす以外に、20% のバッファーを確保することを強くお勧めします。
以下の表に、スイートの共有機能の要件を示します。
| レイヤー | シングルノードの評価プロファイル | マルチノードの高可用性対応の運用環境モード | ||
|---|---|---|---|---|
| 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 |
1 ロボットを大規模にデプロイする場合は、Orchestrator の HPA の容量を増やす必要があります。100,000 を超えるロボットをデプロイする場合は、20 以上のポッドをお勧めします。
RPM パッケージの要件
Automation Suite のインストールを開始する前に、以下の要件を満たしていることを確認する必要があります。
- RHEL のサブスクリプションがある。
- BaseOS リポジトリと AppStream リポジトリを有効化している
- 必要な RPM パッケージがインストールされている。
以下の表に、必要な RPM パッケージのリストを示します。
| RPM パッケージ | 説明 |
|---|---|
iscsi-initiator-utils nfs-utils rpcbind util-linux nmap-ncat openssl httpd-tools gettext zstd | インストールのためにノードに必要です。 |
podman>=4.0.2 nmap-ncat bind-utils openssl wget unzip conmon=>2.0.24 | 準備状況の確認を実行するためにノードに必要です。 |
ansible zip unzip | Ansible が必要な uipathctl.sh の機能を実行するためにオーケストレーション ノードに必要です。 |
iscsi-initiator-utils gettext nfs-utils rpcbind util-linux nmap-ncat openssl httpd-tools podman=>4.0.2 zstd | オフライン インストールでのみ必要です。 |
RHEL 8.4 以降では、必要な RPM パッケージが BaseOS リポジトリと AppStream リポジトリに既定で格納されています。
手動インストール
Automation Suite を手動でクリーン インストールする場合は、RPM パッケージの要件を満たしていることをユーザーが確認する必要があります。この場合、必要な RPM パッケージのインストールはユーザーの責任です。
以前のバージョンの Automation Suite からアップグレードする場合、RPM パッケージはインストール済みです。
RPM パッケージをインストールおよび検証するために使用できるツールについて詳しくは、以下をご覧ください。
クラウド テンプレート
Azure、AWS、または GCP のテンプレートを使用して Automation Suite をインストールする場合、ユーザー側での操作は不要です。RPM パッケージを含む完全なインフラストラクチャがテンプレートによってプロビジョニングされます。
Microsoft SQL Server の一般的な要件
専用の「要件」セクションで特に指定がない限り、これらの要件はすべての Automation Suite 製品に適用されます。
インストールには、前提条件として外部 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 が各クラスター VM からアクセスできることを確認します。
個々の製品サポートの内容は異なります。
デプロイを計画している各製品について、以下のことが必要です。
- 製品で必要とされる SQL Server のサポート バージョンを確認する
- 製品で必要とされる SQL Server 構成の前提条件 (SQL Server のユーザー権限を含む) を適用する
For more information on product-specific SQL Server requirements, see SQL Server configuration for single-node evaluation profile and SQL Server configuration for multi-node HA-ready production profile.
Microsoft SQL Server の一般的な最小ハードウェア要件は次のとおりです。
- 8 (v-)CPU
- 32 GB の RAM
- 256 GB SSD
ここに示す最小要件は一般的な指針であり、運用環境のデプロイにおいて信頼できる動作を保証するものではありません。信頼性のある動作に求められるハードウェア要件を決定するには、要件算出が必要です。
デプロイする予定の各製品について、計画されている使用状況を評価し、製品の指定に従って要件算出の指針を適用する必要があります。この情報は、各製品のヘルプ セクションにあります。
See Configuring Microsoft SQL Server for additional hardware requirements and recommendations for setting up a Microsoft SQL Server database machine for Process Mining.
NFS サーバーの一般的な要件
バックアップを有効化するには、外部 NFS サーバーが必要です。Automation Suite は Linux の NFSv4 をサポートしています。
NFS サーバーが各クラスター VM からアクセスできることを確認します。
NFS サーバーの一般的な最小ハードウェア要件は次のとおりです。
| CPU | RAM | ディスク |
|---|---|---|
| 4 (v-)CPU | 8 GB | 2 TiB の SSD (1100 IOPS) |
RHEL 互換マトリックス
以下の表に、Automation Suite の各バージョンでサポートされている RHEL のバージョンを示します。
| Automation Suite バージョン | RHEL のサポート対象バージョン |
|---|---|
| 2022.10.15 | 8.6, 8.8, 8.9, 8.10, 9.2, 9.4 |
| 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 |
RHEL カーネル バージョン (バージョン kernel-4.18.0-372.91.1.el8_6 および kernel-4.18.0-477.10.1.el8_8 ) は、Automation Suite クラスターのインストールまたは管理を中断させる 問題 の影響を受けます。どの Automation Suite ノードも、インストール前またはインストール後にこれらのバージョンのカーネルを使用していないことを確認してください。