- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 2: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 3: 外部 ObjectStore を構成する
- 手順 4: High Availability Add-on を構成する
- 手順 5: SQL データベースを構成する
- 手順 7: DNS を構成する
- 手順 8: ディスクを構成する
- 手順 9: カーネルと OS レベルの設定を構成する
- 手順 10: ノード ポートを構成する
- 手順 11: その他の設定を適用する
- 手順 12: 必要な RPM パッケージを検証してインストールする
- 手順 13: cluster_config.json を生成する
- Cluster_config.json のサンプル
- 全般的な構成
- プロファイル構成
- 証明書の設定
- データベースの構成
- 外部 ObjectStore の構成
- 署名済み URL の構成
- ArgoCD の構成
- Kerberos 認証の構成
- 外部の OCI 準拠レジストリの設定
- Disaster Recovery - アクティブ/パッシブおよびアクティブ/アクティブの構成
- High Availability Add-on の構成
- Orchestrator 固有の設定
- Insights 固有の構成
- Process Mining 固有の構成
- Document Understanding 固有の構成
- Automation Suite ロボット固有の構成
- 監視の構成
- 任意: プロキシ サーバーを構成する
- 任意: マルチノードの HA 対応の運用クラスターにおけるゾーン障害に対する復元設定を有効化する
- 任意: カスタムの Resolv.con を渡す
- 任意: フォールト トレランスを向上させる
- GPU がサポートされた専用のエージェント ノードを追加する
- Automation Suite ロボット専用のエージェント ノードを追加する
- 手順 15: オフライン インストール用に一時的な Docker レジストリを設定する
- 手順 16: インストールの前提条件を検証する
- uipathc を実行する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 製品を管理する
- Cluster Administration ポータルの利用を開始する
- クラスター内の High Availability Add-on から外部の High Availability Add-on に Redis を移行する
- クラスター内の ObjectStore から外部 ObjectStore に移行する
- クラスター内のレジストリから外部の OCI 準拠レジストリに移行する
- インストール後に FQDN を設定する
- Kerberos 認証を設定する
- 外部ツールへログを転送する
- Kubernetes ログを Elasticsearch に転送する
- シングルノード (評価) デプロイからマルチノード (HA) デプロイへのスケーリング
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- NFS バックアップ ディレクトリの権限を減らす方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- Ceph の読み取り専用モードから移行する
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- TX チェックサム オフロードを無効化する方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- AI Center のストレージを拡張する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- TLSのバージョンを確認する方法
- 証明書の操作方法
- Ceph のバックアップとデータの復元をスケジュールする方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- FIPS が有効化されたクラスターに Insights をデプロイする方法
- cgroup v2 への移行方法
- 仮想マシンの再起動後に Kerberos 認証を回復する方法
- ローカルの Docker イメージをクラスター内のレジストリにプッシュする方法
- バックアップからバケットを除外する方法
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- TLS 証明書の検証エラー
- Antivirus causes installation and operation issues
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- RHEL 8.9 でレジストリの一時インストールが失敗する
- オフライン インストール中に uipath 名前空間のデプロイで頻繁に発生する再起動の問題
- DNS 設定が CoreDNS によって受け入れられない
- メモリ不足によりクラスター内レジストリのシーディングが失敗する
- Document Understanding モダン プロジェクトが有効化されていて、AI Center が無効化されている場合、前提条件の確認に失敗します
- XFS ボリュームマウントの失敗により Pod が Init 状態でスタックする
- Rancher と etcd ディスクのマウント順序が正しくないため、再起動後にクラスターのデータが失われるように見える
- Ceph の異常によりアップグレードが失敗する
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- オフライン環境でアップグレードが失敗する
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- 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 へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- 初回インストール後に ArgoCD が進行中ステートになる
- ArgoCD リポジトリ サーバー ポッドが CrashLoopBackOff になる
- 手動による ArgoCD ネットワーク ポリシーの軽減策 (GHSA-47m3-95c7-g2g8)
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- 診断ヘルスチェック中に報告されたエラーの不一致
- uipathctl で作成されたワークロードのリソース要求と制限を設定する
- アップストリームに正常な問題はありません
- Redis の起動がウイルス対策によってブロックされる
- TLS 証明書の検証が有効化されていると、AI Center と Document Understanding ポッドの起動に失敗する
- Fluentd では、IPv6 環境ではログはエクスポートされません
- デスクトップ版の Studio では Integration Service のコネクタとアクティビティを読み込めない
- Process Mining で高可用性を実行する
- Kerberos を使用してログインすると、Process Mining を取り込むことができなかった
- pyodbc 形式の接続文字列を使用して AutomationSuite_ProcessMining_Warehouse データベースに接続できない
- Airflow のインストールが「sqlalchemy.exc.ArgumentError: Could not parse rfc1738 URL from string ''」で失敗する
- SQL Server ポート 1433 を使用する IP テーブル ルールを追加する方法
- CData Sync を実行しているサーバーの Automation Suite の証明書が信頼されない
- Process Mining を無効化してから再度有効化すると、読み込みに失敗する
- 診断ツールを実行する
- Automation Suite サポート バンドルを使用する
- ログを確認する
インストール後に FQDN を設定する
インストール後に cluster_config.json および uipathctl を使用して Automation Suite の FQDN を更新するためのリファレンス。
Automation Suite の FQDN を更新するには、 cluster_config.json ファイルを更新して uipathctl インストーラーを実行する必要があります。
FQDN の更新プロセスは、シングルノードの評価モードおよびマルチノードの高可用性対応の運用環境モードの両方に適用できます。
FQDN を変更する場合、新しいサーバー証明書が必要になります。 新しい証明書が使用できない場合は、インストーラーによって自動的に構成される、新しい自己署名証明書を使用してインストールを続行するか、インストールを中断して、証明機関が発行した新しい証明書を導入するという 2 つのオプションがあります。
証明書は、cluster_config.json ファイルの [server_certificate] フィールドで設定できます。
構成ファイルを新しい FQDN の値で更新する
小文字の FQDN のみがサポートされています。FQDN では大文字を使用しないでください。
input.json ファイルで以下のパラメーターを更新する必要があります。要件に応じて、これらの値を自由に組み合わせて使用できます。
fqdn- このフィールドを、クラスターへのアクセスに必要な新しい FQDN に更新します。fixed_rke_address- この値がcluster_config.jsonのfqdnフィールドと同じ場合、2 つの値が一致していて新しい FQDN を反映していることを確認する必要があります。アクティブ/パッシブまたはアクティブ/アクティブ設定の場合、この値はcluster_fqdnと一致する必要があります。cluster_fqdn- アクティブ/パッシブまたはアクティブ/アクティブ クラスター用にこのフィールドを更新します。注:いずれかのクラスターのロード バランサー レベルで DNS 構成を変更する場合は、
cluster_fqdn更新が必要です
以下の例は、FQDN を更新するために必要な cluster_config.json の構成を示しています。
{
"fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
"fixed_rke2_address": "new-automationsuite.mycompany.com,"//this is only required for the node joining, if customer wish to change "cluster_fqdn": "new-primary-automationsuite.mycompany.com" //this is only required for the a/p or a/a cluster
}
{
"fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
"fixed_rke2_address": "new-automationsuite.mycompany.com,"//this is only required for the node joining, if customer wish to change "cluster_fqdn": "new-primary-automationsuite.mycompany.com" //this is only required for the a/p or a/a cluster
}
手順 1: インフラストラクチャ レベルで FQDN を更新する
インフラストラクチャ レイヤーで FQDN を更新するには、最初のサーバー マシンでのみインストーラーを実行します。これにより、残りのサーバー ノード、エージェント ノード、特殊なエージェント ノードを含む、クラスター内のその他のすべてのノードが更新されます。
FQDN を更新するには、次のコマンドを実行します。
./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json
./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json
--force フラグを指定してコマンドを実行すると、警告プロンプトが上書きされ、FQDN の変更が直接実行されます。
インストーラーにより、FQDN の更新による影響について警告が表示されます。続行する前に確認を求められます。
[WARN] You are about to change the FQDN of the Automation Suite Cluster.
Changing the fqdn is a disruptive operation, and it will result in
disconnecting your robots, mobile orchestrator users, ML Activities,
and ML Skills and invalidating any pending user invites.
If you wish to continue type 'yes' and hit enter to continue.
[WARN] You are about to change the FQDN of the Automation Suite Cluster.
Changing the fqdn is a disruptive operation, and it will result in
disconnecting your robots, mobile orchestrator users, ML Activities,
and ML Skills and invalidating any pending user invites.
If you wish to continue type 'yes' and hit enter to continue.
手順 2: メンテナンス モードを有効化する
コンポーネントやサービスのレベルで FQDN の更新をトリガーする前に、メンテナンス モードを有効化する必要があります。これにより、イングレス コントローラーとすべての UiPath® サービスがシャットダウンし、Automation Suite クラスターへのすべての受信トラフィックがブロックされます。
クラスターをメンテナンス モードにするには、以下を実行します。
./bin/uipathctl cluster maintenance enable
./bin/uipathctl cluster maintenance enable
クラスターがメンテナンス モードであることを確認するには、以下を実行します。
./bin/uipathctl cluster maintenance is-enabled
./bin/uipathctl cluster maintenance is-enabled
手順 3: コンポーネントとサービスのレベルで FQDN を更新する
FQDN を更新するには、次のコマンドを実行します。
./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json
./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json
--force フラグを指定してコマンドを実行すると、警告プロンプトが上書きされ、FQDN の変更が直接実行されます。
インストーラーにより、FQDN の更新による影響について警告が表示されます。続行する前に確認を求められます。
[WARN] You are about to change the FQDN of the Automation Suite Cluster.
Changing the fqdn is a disruptive operation, and it will result in
disconnecting your robots, mobile orchestrator users, ML Activities,
and ML Skills and invalidating any pending user invites.
If you wish to continue type 'yes' and hit enter to continue.
[WARN] You are about to change the FQDN of the Automation Suite Cluster.
Changing the fqdn is a disruptive operation, and it will result in
disconnecting your robots, mobile orchestrator users, ML Activities,
and ML Skills and invalidating any pending user invites.
If you wish to continue type 'yes' and hit enter to continue.
FQDN に関連する新しい有効な証明書が存在しない場合も、警告が表示されます。証明書の検証に失敗した場合、CA によって発行された新しい証明書を指定するか、新しい自己署名証明書で続行するよう要求されます。
************************************************************************************
[ERROR] Validating certificate... Failed
[ERROR] Certificate doesn't have new-automationsuite.mycompany.com in the SAN
************************************************************************************
Certificate provided is invalid for the new fqdn, would you like us to configure the new self signed certificate?
If you wish to continue type `yes` and hit enter to continue.
************************************************************************************
[ERROR] Validating certificate... Failed
[ERROR] Certificate doesn't have new-automationsuite.mycompany.com in the SAN
************************************************************************************
Certificate provided is invalid for the new fqdn, would you like us to configure the new self signed certificate?
If you wish to continue type `yes` and hit enter to continue.
必ず Redis データベースからすべてのデータをクリアしてください。 これを行うには、FLUSHALL コマンドを実行します。
手順 4: メンテナンス モードを無効化する
FQDN の更新後、メンテナンス モードを無効化して、トラフィックを Automation Suite クラスターに復元します。
メンテナンス モードを無効化するには、次のコマンドを実行します。
./bin/uipathctl cluster maintenance disable
./bin/uipathctl cluster maintenance disable
詳しくは、「 uipathctl cluster maintenance disable (uipathctl) クラスターのメンテナンスを無効化する」をご覧ください。
アクティブ/アクティブ デプロイの FQDN を更新する
アクティブ/アクティブ設定でプライマリ クラスターの FQDN を変更する場合は、以下の追加手順を実行する必要があります。
-
プライマリ クラスターでメンテナンス モードを有効化します。
./bin/uipathctl cluster maintenance enable./bin/uipathctl cluster maintenance enable -
プライマリ クラスター用に新しい kubeconfig を生成します。
-
セカンダリ クラスターの
cluster_config.jsonにあるother_kube_configの下に、新しい kubeconfig を追加します。 -
セカンダリ クラスターで次のコマンドを実行します。
uipathctl manifest apply cluster_config.json --versions versions/helm-charts.jsonuipathctl manifest apply cluster_config.json --versions versions/helm-charts.json -
プライマリ クラスターでメンテナンス モードを無効化します。
./bin/uipathctl cluster maintenance disable./bin/uipathctl cluster maintenance disable詳しくは、「 uipathctl cluster maintenance disable (uipathctl) クラスターのメンテナンスを無効化する」をご覧ください。