- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 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 を実行する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- 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 サポート バンドルを使用する
- ログを確認する
アップグレードを実行する
Automation Suite クラスターのアップグレード (メンテナンス モード、バックアップ手順、アップグレード プロセスを含む) を実行します。
Automation Suite のアップグレードを実行するには、クラスターをメンテナンス モードにする必要があります。メンテナンス モードでは、アップグレード プロセス全体でダウンタイムが発生します。その間、ビジネス オートメーションは中断されます。 アップグレードの前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。
アップグレードを実行するには、次の手順を実行する必要があります。
- 前提条件の確認を実行します。
- バックアップを構成します。
- バックアップを無効化します。
- クラスターをメンテナンス モードにします。
- Longhorn ワークロード、MongoDB データ、Ceph を Helm ベースのデプロイに移行します。
- Kubernetes およびその他のインフラストラクチャ コンポーネントを更新します。
- 共有コンポーネントと UiPath® サービスをアップグレードします。
前提条件の確認を実行する
クラスターをメンテナンス モードにする前に、アップグレードの要件がすべて満たされていることを確認する必要があります。
-
次のコマンドを使用して、インフラストラクチャの前提条件の確認を実行します。
cd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.jsoncd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json -
次のコマンドを使用して、共有コンポーネントとサービスの前提条件の確認を実行します。
cd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.jsoncd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json
Automation Suite の現在のバージョンで大文字の FQDN が使用されている場合、前提条件の確認は失敗し、小文字の FQDN に切り替えるよう求めるメッセージが表示されます。この場合は、アップグレードを続行する前に FQDN を小文字に更新してください。手順については、「 インストール後に FQDN を設定する」をご覧ください。
バックアップを構成する
バックアップを構成するには、次の手順に従います。
-
クラスターでバックアップが有効であることを確認します。現在のデプロイで使用したバージョンと同じバージョンのインストーラーを使用してバックアップを作成する必要があります。
詳しくは、Automation Suite のアップグレード元のバージョンに対応するバックアップと復元のドキュメントをご覧ください。たとえば、Automation Suite 2023.4 からのアップグレードを計画している場合は、詳しくは、v2023.4 のガイドをご覧ください。
-
SSH を介していずれかのサーバー ノードに接続します。
-
必要なすべてのボリュームがクラスターにバックアップされていることを確認します。
-
2022.4 以前からアップグレードする場合は、次のコマンドを実行します。
/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup -
2022.10 以降からアップグレードする場合は、次のコマンドを実行します。
./configureUiPathAS.sh snapshot list./configureUiPathAS.sh snapshot list -
2024.10 以降からアップグレードする場合は、次のコマンドを実行します。
./bin/uipathctl snapshot list./bin/uipathctl snapshot list
-
バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。
バックアップが作成されたら、続いて次の手順を実行します。
23.10.0 以降のバージョンからアップグレードする場合は、必ずターゲット バージョン ディレクトリから uipathctl コマンドを使用してください。
バックアップを無効化する
クラスターをメンテナンス モードにする前に、バックアップを無効化して、クラスターが最適でないステートでバックアップされないようにする必要があります。詳細については、「 スナップショットのバックアップを無効化する」をご覧ください。
クラスターをメンテナンス モードにする
クラスターをメンテナンス モードにすると、イングレス コントローラーとすべての 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
アップグレード前の移行操作を実行する
次の必須のアップグレード前コマンドを実行します。
./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions
./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions
このコマンドは、Longhorn のワークロードをローカルの PV に、MongoDB のデータを SQL に選択的に移行し、Ceph のデプロイを ArgoCD から Helm ベースのデプロイに移行します。
Kubernetes およびその他のインフラストラクチャ コンポーネントを更新する
Kubernetes およびその他のインフラストラクチャ コンポーネントをアップグレードするには、プライマリ サーバー ノードで次のコマンドを実行します。
生成された cluster_config.json ファイルを、「クラスター構成を更新する」の説明に従って更新したことを確認してください。
Automation Suite 2.2510.0 以降、Task Mining は利用できなくなったため、専用の Task Mining ノードがある場合は、「 クラスターからノードを削除する」の手順に従って、そのノードをクラスターから削除できます。
Automation Suite でノードを再利用する場合は、次のコマンドを実行してtaint を削除できます。
kubectl taint nodes <nodename> task.mining/cpu=present:NoSchedule-
kubectl taint nodes <nodename> task.mining/cpu=present:NoSchedule-
cd /opt/UiPathAutomationSuite/latest/installer
./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json
cd /opt/UiPathAutomationSuite/latest/installer
./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json
-
前のコマンドをプライマリ サーバー ノードで実行すると、インストーラーと
cluster_config.jsonが/opt/UiPathAutomationSuite/<version>/installerの既定の場所にコピーされ、すべてのマシンのインフラストラクチャがアップグレードされます。 -
/opt/UiPathAutomationSuite/<version>の既定の場所には、すべてのノードで 5 GB 以上の空き容量が必要です。 -
既定の場所を変更するには、次の環境変数を目的の場所で更新します。その場所がすべてのノードで利用可能であり、アップグレードを実行するために必要なアクセス許可があることを確認します。
export INSTALLER_DIRECTORY=/path/to/copy/installerexport INSTALLER_DIRECTORY=/path/to/copy/installer -
前のコマンドを実行してアップグレードを実行すると、インストーラーが
/path/to/copy/installer/<version>/installerの場所にコピーされます。versionは、実行するインストーラーのバージョンに置き換えられます。
トラブルシューティング
- インストーラーにカスタムの場所を明示的に使用していない限り、プライマリ サーバーのアップグレード ログは
/opt/UiPathAutomationSuite/latest/installer/upgrade-logsの既定の場所にあります。 - 他のすべてのノードでは、
INSTALLER_DIRECTORY変数を使用して場所を明示的に変更しない限り、ログは/opt/UiPathAutomationSuite/<version>/installer/upgrade-logsの既定の場所にあります。
共有コンポーネントと UiPath® サービスをアップグレードする
-
Insights を有効化している場合は、次のコマンドを実行して、アップグレード後も Insights のデータが保持されるようにする必要があります。
kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -注:Insights が有効でない場合、このコマンドを実行しても悪影響はありません。
-
共有コンポーネントと UiPath® 製品サービスをアップグレードするには、プライマリ サーバー ノードで次のコマンドを実行します。
cd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.jsoncd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json -
クラスターをメンテナンス モードから解除するには、プライマリ サーバー ノードで次のコマンドを実行します。
cd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl cluster maintenance disablecd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl cluster maintenance disable重要:このアップグレードにより UiPath® 製品ポッドが復元されます。これは、新しいバージョンのグラフでは ArgoCD の同期時にレプリカ数が設定されるためです。ただし、クラスターがメンテナンス モードに移行することはありません。明示的に
uipathctl cluster maintenance disableを実行する必要があります。実行するまで、メンテナンス モードが中断された CronJobs は中断されたままになり、メンテナンス モードが追加された
uipath.com/last_replica_count注釈はデプロイと StatefulSet に残ります。その注釈が存在する間は、後続のuipathctl cluster maintenance enableはそれらのワークロードをスキップし、スケール ダウンしません。注:uipathctl cluster maintenance is-enabledは、デプロイ レプリカと ArgoCD アプリケーションのみを評価します。アップグレードによってレプリカが復元されるため、このコマンドは、CronJobs が中断されている間、メンテナンス モードが無効になっていることを報告できます。を実行しますuipathctl cluster maintenance disable。詳しくは、「 uipathctl cluster maintenance disable (uipathctl) クラスターのメンテナンスを無効化する」をご覧ください。
-
Automation Suite が正常かどうかを確認するには、次のいずれかのコマンドを実行します。
cd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl health checkcd /opt/UiPathAutomationSuite/latest/installer ./bin/uipathctl health check注:helm-charts.json見つからない場合は、代わりにversions.jsonを使用することもできます。versions.jsonをダウンロードするには、「インストール パッケージをダウンロードする」をご覧ください。
アップグレードの完了後、該当するクリーンアップと移行のアクティビティを実行します。