- 概要
- 要件
- 推奨: デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 1: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 2: 外部 ObjectStore を構成する
- 手順 3: High Availability Add-on を構成する
- 手順 4: Microsoft SQL Server を構成する
- 手順 5: ロード バランサーを構成する
- 手順 6: DNS を構成する
- 手順 7: カーネルと OS レベルの設定を構成する
- 手順 8: ディスクを構成する
- 手順 9: ノード ポートを構成する
- 手順 10: その他の設定を適用する
- 手順 12: 必要な RPM パッケージを検証してインストールする
- 手順 13: cluster_config.json を生成する
- 証明書の設定
- データベースの構成
- 外部 ObjectStore の構成
- 署名済み URL の構成
- 外部の OCI 準拠レジストリの設定
- 障害復旧: アクティブ/パッシブおよびアクティブ/アクティブ構成
- 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 インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- NIC チェックサムオフロードを無効にする方法
- Automation Suite 2022.10.10 および 2022.4.11 から 2023.10.2 にアップグレードする方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- 2021.10 からの自動アップグレード後にクラスターが異常になる
- Ceph の異常によりアップグレードが失敗する
- 領域の問題のために rke2 が開始しない
- ボリュームがマウントできず、アタッチ/デタッチ ループ状態のまま
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- 異常な Insights コンポーネントが原因で移行が失敗する
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- Docker レジストリの移行が PVC の削除段階でスタックする
- v2023.10 へのアップグレード後に AI Center をプロビジョニングできない
- オフライン環境でアップグレードが失敗する
- 管理ポータルのタイムアウト期間を設定する
- 移行後に認証が機能しない
- 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 へのログインに失敗した
- 基になるディレクトリ接続を更新する
- 診断ツールを実行する
- Automation Suite サポート バンドル ツールを使用する
- ログを確認する
手順 8: ディスクを構成する
Automation Suite のインストール実行前に、LVM を使用してディスクのパーティション設定と構成を行い、データ移行やデータ損失が生じることなく、ディスク サイズを容易に変更できるようにする必要があります。
/var
パーティション下にインストールされ、このパーティションには既定で 8 GiB しか割り当てられていないためです。
- サポート対象のディスク フォーマットは
ext4
またはxfs
です。 - パーティションは、すべて LVM を使用して作成し、クラスターのデータが異なるディスク上にある可能性があっても、一貫性のある表示を保証する必要があります。これは将来、データ移行のリスクやデータ損失なしに、パーティションのサイズを拡張できるようにするためにも役立ちます。
- すべてのポッドとアプリケーション ログは、
/var/log/pods
ディレクトリに保存されます。このディレクトリの容量が 8 GiB 以上であることを確認してください。また、logrotate
を設定して、ログを毎日~毎週の間隔でローテーションすることをお勧めします。
オンライン インストールとオフライン インストールのディスク要件は同じですが、オフラインの UiPath® バンドルを解凍するために必要な領域が異なります。
RHEL OS の場合は、マシン上のマウント ポイントの最小サイズが、以下を満たすようにする必要があります。
ディスク ラベル |
サーバー |
オペレーター |
パーティション |
Size |
目的 |
---|---|---|---|---|---|
クラスター ディスク |
|
|
|
190 GiB |
コンテナーのイメージとレイヤーを格納します。 |
|
56 GiB |
シークレット、構成マップ、emptyDir などのランタイム Kubernetes 構成が格納されます。 | |||
|
10 GiB |
インストーラーのバイナリを格納します。 | |||
etcd ディスク |
|
|
|
16 GiB |
Kubernetes 用の分散データベースを格納します。 |
ブロック ストレージ |
|
|
|
15 GiB |
Insights に必要です。 |
|
50 GiB |
監視ツールに必要です。 | |||
/datadisk/registry 1 |
200 GiB |
Docker レジストリに必要です。 | |||
/datadisk/objectstore 2 |
10 Gib |
ceph-mon に必要です。 | |||
ObjectStore2 |
|
|
N/A | 512 GiB |
クラスター内の ObjectStore に必要です。 |
AI Center3 |
|
|
N/A |
1 つのトレーニング パイプラインにつき最小 51 GiB、推奨105 GiB。 |
AI Center をインストールする場合にのみ必要です。 |
UiPath® バンドル ディスク |
|
| /uipath | 512 GiB |
オフライン バンドルを保存するためにオフライン インストールでのみ必要です。 |
2 これはクラスター内の ObjectStore を指し、外部 ObjectStore を使用する場合は適用されません。
3 これは、AI Center のトレーニング パイプラインで必要なストレージを指します。このディスクは、AI Center のトレーニング パイプラインを実行する予定のマシン、および専用の Task Mining ノードにのみ必要です。エージェント マシンにこのディスクをアタッチすることをお勧めします。
各プロセスに公平にリソースが配分されるようにするため、上記のどの目的でも OS ディスクを使用しないことをお勧めします。
configureUiPathDisks.sh
スクリプトを使用できます。
ダウンロード手順については、「configureUiPathDisks.sh」をご覧ください。
configureUiPathDisks.sh
スクリプトは、次の目的に使用できます。
- 新しい Automation Suite クラスターをインストールするためのディスクとマウント ポイントを構成する
- インストール後にデータ ディスクのサイズを変更する
スクリプトを実行可能にするには、次のコマンドを実行します。
chmod +x ./configureUiPathDisks.sh
chmod +x ./configureUiPathDisks.sh
スクリプトの必要な権限を付与するには、次のコマンドを実行します。
chmod +x configureUiPathDisks.sh
chmod +x configureUiPathDisks.sh
スクリプトの使用方法の詳細を表示するには、次のコマンドを実行します。
sudo ./configureUiPathDisks.sh --help
sudo ./configureUiPathDisks.sh --help
クラスター ディスクを構成するには、すべてのマシンで次のコマンドを実行します。
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk
etcd ディスクを構成するには、すべてのサーバー マシンで次のコマンドを実行します。
./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk
./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk
データ ディスクを構成するには、すべてのサーバー マシンで次のコマンドを実行します。
./configureUiPathDisks.sh --volume name_of_data_disk
./configureUiPathDisks.sh --volume name_of_data_disk
フラグ |
値 (Value) |
---|---|
|
ディスク名の例:
/dev/sde 監視、Insights、ObjectStore、レジストリ用のさまざまなマウントをホストするディスクにパーティションを設定するときに、ディスク名が必要です。 ディスクの初回構成では、ディスク名の指定が必須です。後続の実行時に指定されない場合は、
uipathdatavg に関連付けられている既存のディスクを使用して、選択したコンポーネントのパーティションが作成されます。
|
|
任意です。外部レジストリが利用できない場合にのみ必要です。 |
|
任意です。最初の実行時にフラグが渡されない場合は、監視用のパーティションが自動的に作成されます。ただしこのフラグは、後続の実行で
--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 GiB に変更する方法を示しています。
この手順は、外部の 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 ディスクを構成するには、トレーニング パイプラインを実行する予定のマシンで次のコマンドを実行します。
./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partition
./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partition
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
この手順は、専用の 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
fstab
ファイルに追加し、それらの fstab
エントリに nofail
オプションを指定して、障害発生時の仮想マシンのブートに影響を及ぼさないようにしてください。
/etc/fstab
が正しく構成され、システムの再起動を処理できることを確認するには、以下の手順で次のコマンドを実行します。
mount -afv
mount -afv
以下の出力を取得できます。
/var/lib/rancher : already mounted
/var/lib/kubelet : already mounted
/opt/UiPathAutomationSuite : already mounted
/datadisk/monitoring : already mounted
/datadisk/insights : already mounted
/var/lib/rancher/rke2/server/db : 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
/var/lib/rancher : already mounted
/var/lib/kubelet : already mounted
/opt/UiPathAutomationSuite : already mounted
/datadisk/monitoring : already mounted
/datadisk/insights : already mounted
/var/lib/rancher/rke2/server/db : 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 ロボットのパッケージ キャッシュのホスティング ディスクを構成する
- 最初のサーバー ノードでバンドル ディスクをクラスター内レジストリ用に構成する
- ディスク マウントを検証する