- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 2: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 3: 外部 ObjectStore を構成する
- 手順 4: High Availability Add-on を構成する
- 手順 5: SQL データベースを構成する
- 手順 6: ロード バランサーを構成する
- 手順 7: DNS を構成する
- 手順 8: ディスクを構成する
- 手順 9: カーネルと OS レベルの設定を構成する
- 手順 10: ノード ポートを構成する
- 手順 11: その他の設定を適用する
- 手順 12: 必要な RPM パッケージを検証してインストールする
- 手順 13: cluster_config.json を生成する
- 証明書の設定
- データベースの構成
- 外部 ObjectStore の構成
- 署名済み URL の構成
- Kerberos 認証の構成
- 外部の OCI 準拠レジストリの設定
- Disaster Recovery - アクティブ/パッシブおよびアクティブ/アクティブの構成
- High Availability Add-on の構成
- Orchestrator 固有の設定
- Insights 固有の構成
- Process Mining 固有の構成
- Document Understanding 固有の構成
- Automation Suite ロボット固有の構成
- 監視の構成
- 任意: プロキシ サーバーを構成する
- 任意: マルチノードの HA 対応の運用クラスターにおけるゾーン障害に対する復元設定を有効化する
- 任意: カスタムの Resolv.con を渡す
- 任意: フォールト トレランスを向上させる
- install-uipath.sh パラメーター
- GPU がサポートされた専用のエージェント ノードを追加する
- Task Mining 専用のエージェント ノードを追加する
- Task Mining アプリケーションを接続する
- Automation Suite ロボット専用のエージェント ノードを追加する
- 手順 15: オフライン インストール用に一時的な Docker レジストリを設定する
- 手順 16: インストールの前提条件を検証する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- TX チェックサム オフロードを無効化する方法
- Automation Suite 2022.10.10 および 2022.4.11 から 2023.10.2 にアップグレードする方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- AI Center のストレージを拡張する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- 証明書の操作方法
- アプリケーション ログを Splunk に転送する方法
- レジストリ ポッドから未使用の Docker イメージをクリーンアップする方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- サポート バンドルのログ収集の失敗
- Test Automation SQL の接続文字列は無視されます
- Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる
- シングルノードのアップグレードがファブリック ステージで失敗する
- 2021.10 からの自動アップグレード後にクラスターが異常になる
- Ceph の異常によりアップグレードが失敗する
- 領域の問題のために rke2 が開始しない
- ボリュームがマウントできず、アタッチ/デタッチ ループ状態のまま
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- 異常な Insights コンポーネントが原因で移行が失敗する
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- Docker レジストリの移行が PVC の削除段階でスタックする
- v2023.10 以降へのアップグレード後に AI Center のプロビジョニングが失敗する
- オフライン環境でアップグレードが失敗する
- アップグレード中に SQL の検証が失敗する
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- Longhorn REST API エンドポイントのアップグレード/再インストール エラー
- Insights の PVC サイズが上書きされたためにアップグレードが失敗する
- 管理ポータルのタイムアウト期間を設定する
- 移行後に認証が機能しない
- 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 へのログインに失敗した
- 基になるディレクトリ接続を更新する
- Process Mining で高可用性を実行する
- Kerberos を使用してログインすると、Process Mining を取り込むことができなかった
- 障害復旧後、Dapr が Process Mining に対して正しく機能しない
- クラスター モードで Redis を使用した Dapr を構成する
- pyodbc 形式の接続文字列を使用して AutomationSuite_ProcessMining_Warehouse データベースに接続できない
- Airflow のインストールが「sqlalchemy.exc.ArgumentError: Could not parse rfc1738 URL from string ''」で失敗する
- SQL Server ポート 1433 を使用する IP テーブル ルールを追加する方法
- CData Sync を実行しているサーバーの Automation Suite の証明書が信頼されない
- 診断ツールを実行する
- Automation Suite サポート バンドルを使用する
- ログを確認する
- 要約されたテレメトリを確認する

Linux の Automation Suite のインストール ガイド
Automation Suite のインストール実行前に、LVM を使用してディスクのパーティション設定と構成を行い、データ移行やデータ損失が生じることなく、ディスク サイズを容易に変更できるようにする必要があります。
/var パーティション下にインストールされ、このパーティションには既定で 8 GB しか割り当てられていないためです。
- サポート対象のディスク フォーマットは
ext4またはxfsです。 - パーティションは、すべて LVM を使用して作成し、クラスターのデータが異なるディスク上にある可能性があっても、一貫性のある表示を保証する必要があります。これは将来、データ移行のリスクやデータ損失なしに、パーティションのサイズを拡張できるようにするためにも役立ちます。
- すべてのポッドとアプリケーション ログは、
/var/log/podsディレクトリに保存されます。 このディレクトリの容量が 8 GB 以上であることを確認してください。 また、毎日から毎週の間隔でログをローテーションするようにlogrotateを構成することをお勧めします。
オンライン インストールとオフライン インストールのディスク要件は同じですが、オフラインの UiPath® バンドルを解凍するために必要な領域が異なります。
RHEL OS の場合は、マシン上のマウント ポイントの最小サイズが、以下を満たすようにする必要があります。
|
ディスク ラベル |
サーバー |
オペレーター |
パーティション |
Size |
目的 |
|---|---|---|---|---|---|
|
クラスター ディスク |
|
|
|
190ギガバイト |
コンテナーのイメージとレイヤーを格納します。 |
|
|
56ギガバイト |
シークレット、構成マップ、emptyDir などのランタイム Kubernetes 構成が格納されます。 | |||
|
|
10 GB |
インストーラーのバイナリを格納します。 | |||
|
etcd ディスク |
|
|
|
16 GB |
Kubernetes 用の分散データベースを格納します。 |
|
ブロック ストレージ |
|
|
|
15ギガバイト |
Insights に必要です。 |
|
|
50 GB |
監視ツールに必要です。 | |||
/datadisk/registry1 |
200ギガバイト |
Docker レジストリに必要です。 | |||
/datadisk/objectstore2 |
10 GB |
ceph-mon に必要です。 | |||
|
ObjectStore2 |
|
|
N/A | 512 GB |
クラスター内の ObjectStore に必要です。 |
|
AI Center3 |
|
|
N/A |
1 つのトレーニング パイプラインにつき最小 51 GB、推奨105 GB。 |
AI Center をインストールする場合にのみ必要です。 |
|
UiPath® バンドル ディスク |
|
| /uipath | 512 GB |
オフライン バンドルを保存するためにオフライン インストールでのみ必要です。 |
2 これはクラスター内の ObjectStore を指し、外部 ObjectStore を使用する場合は適用されません。
3 これは、AI Center のトレーニング パイプラインで必要なストレージを指します。このディスクは、AI Center のトレーニング パイプラインを実行する予定のマシン、および専用の Task Mining ノードにのみ必要です。エージェント マシンにこのディスクをアタッチすることをお勧めします。
各プロセスに公平にリソースが配分されるようにするため、上記のどの目的でも OS ディスクを使用しないことをお勧めします。
スクリプトをダウンロードする
configureUiPathDisks.sh スクリプトを使用できます。
ダウンロード手順については、「configureUiPathDisks.sh」をご覧ください。
スクリプトを実行する
configureUiPathDisks.sh スクリプトは、次の目的に使用できます。
- 新しい Automation Suite クラスターをインストールするためのディスクとマウント ポイントを構成する
- インストール後にデータ ディスクのサイズを変更する
スクリプトを実行可能にするには、次のコマンドを実行します。
chmod +x ./configureUiPathDisks.shchmod +x ./configureUiPathDisks.shスクリプトの必要な権限を付与するには、次のコマンドを実行します。
chmod +x configureUiPathDisks.shchmod +x configureUiPathDisks.shスクリプトの使用方法の詳細を表示するには、次のコマンドを実行します。
sudo ./configureUiPathDisks.sh --helpsudo ./configureUiPathDisks.sh --helpすべてのマシンでクラスター ディスクを構成する
クラスター ディスクを構成するには、すべてのマシンで次のコマンドを実行します。
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk ./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk すべてのサーバー マシンで etcd ディスクを構成する
etcd ディスクを構成するには、すべてのサーバー マシンで次のコマンドを実行します。
./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk ./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk etcd ディスクの構成は、クラスター ディスクの構成が完了した後にのみ実行する必要があります。
etcd ディスクはクラスター ディスク内にマウントされるため、設定の順序を維持する必要があります。
クラスター ディスクを構成する前にこの手順を実行すると、マシンの再起動時にデータが失われる可能性があります。カーネルは、最初にクラスター ディスク、etcd ディスクの順にディスクを自動的にマウントするためです。
すべてのサーバー マシンでデータ ディスクを構成する
lsblkコマンドを実行して、すべてのブロックデバイス、そのサイズ、およびマウントポイントを一覧表示します。ディスク サイズを使用して関連するディスクを特定します ( --volume フラグでは、512 GB のデータ ディスクを使用する必要があります)。
すべてのサーバー マシンで次のコマンドを実行し、要件に基づいて必要なフラグを指定します。
./configureUiPathDisks.sh --volume name_of_data_disk./configureUiPathDisks.sh --volume name_of_data_disk|
フラグ |
値 (Value) |
|---|---|
|
|
ディスク名の例:
/dev/sde監視、Insights、ObjectStore、レジストリ用のさまざまなマウントをホストするディスクにパーティションを設定するときに、ディスク名が必要です。 ディスクの初回構成では、ディスク名の指定が必須です。後続の実行時に指定されない場合は、
uipathdatavg に関連付けられている既存のディスクを使用して、選択したコンポーネントのパーティションが作成されます。
|
|
|
任意です。外部レジストリが利用できない場合にのみ必要です。 |
|
|
随意。 初回実行時にフラグが渡されない場合は、監視用のパーティション (Prometheus ストレージ) が自動的に作成されます。 ただし、このフラグは、後続の実行で、
--resize フラグとともにモニター・パーティションのサイズ変更時に必要になります。
|
|
|
任意です。外部の ObjectStore が利用できない場合にのみ必要です。 |
|
|
任意です。最初の実行時にフラグが渡されない場合は、Insights のパーティションが自動的に作成されます。ただしこれは、後続の実行で
--resize フラグとともに Insights パーティションのサイズ変更時に必要になります。
|
|
|
任意です。整数値を指定すると、十分な空き領域がある場合は、選択したコンポーネントのサイズが変更されます。空き領域が不足している場合は、選択したパーティションを拡張するためにディスク全体が使用されます。サイズ変更しなければならないパーティションを 1 つだけ指定する必要があります。 |
|
|
Automation Suite ロボット ノード上の、キャッシュするパッケージをダウンロードする場所へのパスです。 これは、Automation Suite ロボット ノードでのみ実行する必要があります。 |
--resize フラグを使用して選択したパーティションのサイズを変更することもできます。
./configureUiPathDisks.sh --volume /dev/sde --docker-registry --resize 300./configureUiPathDisks.sh --volume /dev/sde --docker-registry --resize 300/dev/sde ディスクを既存のデータ ディスクに接続する方法と、Docker レジストリ パーティションのサイズを 300 GB に変更する方法を示しています。
すべてのサーバー マシンで ObjectStore ディスクを構成する
この手順は、外部の ObjectStore が利用できない場合にのみ必要です。
次のスクリプトをすべてのサーバー ノードで実行して、クラスター内の ObjectStore のストレージ サイズを追加または拡張できます。
./configureUiPathDisks.sh --ceph-raw-disk-name name_ceph_raw_disk./configureUiPathDisks.sh --ceph-raw-disk-name name_ceph_raw_disk-
Azure の既知の問題により、Azure ディスクが非 SSD として誤ってマークされます。Azure がクラウド プロバイダーであり、ObjectStore ディスクを構成したい場合は、「トラブルシューティング」の手順に従ってください。
-
既存のディスクの垂直スケーリングはサポートされていません。インストール後にクラスター内のストレージのサイズを増やすには、新しい RAW ディスクを追加してください。
選択したマシンで AI Center ディスクを構成する
AI Center ディスクを構成するには、トレーニング パイプラインを実行する予定のマシンで次のコマンドを実行します。
./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partition./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partitionAI Center のストレージを拡張するには、以下の手順を実行します。
-
新しい AI Center ディスクを追加する場合は、ディスクを追加する予定のマシンで次のコマンドを実行します。
./configureUiPathDisks.sh --aicenter-storage-extend name_of_new_aicenter_disk_to_attach./configureUiPathDisks.sh --aicenter-storage-extend name_of_new_aicenter_disk_to_attach -
既存の AI Center ディスクを拡張した場合は、基になる AI Center ディスクが拡張されているマシンで次のコマンドを実行します。
./configureUiPathDisks.sh --aicenter-storage-extend./configureUiPathDisks.sh --aicenter-storage-extend
Automation Suite ロボットのパッケージ キャッシュのホスティング ディスクを構成する
この手順は、専用の Automation Suite ロボット エージェントを使用しないシングルノード設定の場合に必要です。
サーバー ノードで Automation Suite ロボットのパッケージ キャッシュをホストするには、10 GB 以上のディスクを作成する必要があります。
./configureUiPathDisks.sh --volume name_of_data_disk --robot-package-cache./configureUiPathDisks.sh --volume name_of_data_disk --robot-package-cache最初のサーバー ノードでバンドル ディスクをクラスター内レジストリ用に構成する
この手順は、次のシナリオで必要です。
-
オフライン (エアギャップ) インストールを実行する場合。
-
外部レジストリが使用できない場合。
バンドル ディスクを構成するには、最初のサーバー ノードでのみ次のコマンドを実行します。
./configureUiPathDisks.sh --bundle-disk-name name_of_bundle_disk ./configureUiPathDisks.sh --bundle-disk-name name_of_bundle_disk fstab ファイルに追加し、それらの fstab エントリに nofail オプションを指定して、障害発生時の仮想マシンのブートに影響を及ぼさないようにしてください。
/etc/fstab が正しく構成され、システムの再起動を処理できることを確認するには、以下の手順で次のコマンドを実行します。
mount -afvmount -afv以下の出力を取得できます。
# Servers
/datadisk/monitoring : already mounted
/datadisk/insights : already mounted
/var/lib/rancher/rke2/server/db : already mounted
# Servers or agents
/opt/UiPathAutomationSuite : already mounted
/var/lib/rancher : already mounted
/var/lib/kubelet : already mounted
# In case of an offline environment, only on the primary server node
/uipath : already mounted
# Additional mount point is require if customer is installing offline with internal registry
/datadisk/registry : already mounted
# Additional mount point is require if customer is using in-cluster objectstore
/datadisk/objectstore : already mounted# Servers
/datadisk/monitoring : already mounted
/datadisk/insights : already mounted
/var/lib/rancher/rke2/server/db : already mounted
# Servers or agents
/opt/UiPathAutomationSuite : already mounted
/var/lib/rancher : already mounted
/var/lib/kubelet : already mounted
# In case of an offline environment, only on the primary server node
/uipath : already mounted
# Additional mount point is require if customer is installing offline with internal registry
/datadisk/registry : already mounted
# Additional mount point is require if customer is using in-cluster objectstore
/datadisk/objectstore : already mounted- ディスクのパーティションを設定する
- スクリプトを使用してディスクを構成する
- スクリプトをダウンロードする
- スクリプトを実行する
- すべてのマシンでクラスター ディスクを構成する
- すべてのサーバー マシンで etcd ディスクを構成する
- すべてのサーバー マシンでデータ ディスクを構成する
- すべてのサーバー マシンで ObjectStore ディスクを構成する
- 選択したマシンで AI Center ディスクを構成する
- Automation Suite ロボットのパッケージ キャッシュのホスティング ディスクを構成する
- 最初のサーバー ノードでバンドル ディスクをクラスター内レジストリ用に構成する
- ディスク マウントを検証する