- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベストプラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バンドルに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn スナップショットを自動的にクリーンアップする方法
- NIC チェックサムオフロードを無効にする方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で Backlog_wait_time を 1 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- インストールおよびアップグレード中に RKE2 が失敗する
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- 移行後にログインできない
- Kinit: Cannot Find KDC for Realm <AD Domain> While Getting Initial Credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- GSSAPI operation failed with error: An invalid status code was supplied (Client's credentials have been revoked).
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- Login Failed for User <ADDOMAIN><aduser>.Reason: The Account Is Disabled.
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初期インストール後、ArgoCD アプリが Progressing ステートになる
- MongoDB ポッドが CrashLoopBackOff になるか、削除後に PVC プロビジョニングの保留中になる
- Unexpected inconsistency; run fsck manually
- クラスターの復元後に MongoDB またはビジネス アプリケーションの機能が低下する
- self-heal-operator および sf-k8-utils リポジトリが見つからない
- クラスターの復元またはロールバック後にサービスが異常になる
- RabbitMQ ポッドが CrashLoopBackOff でスタックする
- Prometheus が CrashloopBackoff ステートでメモリ不足 (OOM) エラーを伴う
- 監視ダッシュボードに Ceph-rook メトリックが表示されない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドル ツールを使用する
- ログを確認する
Automation Suite をアップグレードする
Automation Suite をアップグレードすると、クラスターでメンテナンス モードが有効化されるため、アップグレードの期間中ダウンタイムが発生します。
Automation Suite クラスターが 2021.10.3 または 2021.10.4 であった場合、新しい Automation Suite のバージョンにアップグレードする前に、追加の手順を実行して Ceph ObjectStore のバージョンをダウングレードする必要があります。手順については、「Ceph を 16.2.6 から 15.2.9 にダウングレードする」をご覧ください。
- 新しい Automation Suite のバージョンのハードウェアおよびソフトウェアの要件を満たしていることを確認します。
-
必要なインストーラーとバンドル ファイルをダウンロードします。
インストールの種類
ダウンロードするファイル
オンライン
sf-installer.zip
– 必須です。ダウンロード手順については「sf-installer.zip」をご覧ください。
オフライン
sf-installer.zip
– 必須です。ダウンロード手順については「sf-installer.zip」をご覧ください。sf-infra.tar.gz
– 必須です。ダウンロード手順については「sf-infra.tar.gz」をご覧ください。sf.tar.gz
– 必須です。ダウンロード手順については「sf.tar.gz」をご覧ください。
重要:Automation Suite をアップグレードする前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。
クラスターのデータは NFS サーバー上にバックアップされます。続行する前に、NFS サーバーが構成されていることを確認してください。
次の図に、アップグレード操作を正常に実行するために必要な手順を示します。
完全なアップグレード操作を実行するには、以下の手順に従います。
- 可能であれば、クラスターを新しいバージョンにアップグレードする前に、バックアップを構成します。
- クラスター ネットワークを停止してクラスターでメンテナンス モードを有効化し、アップグレード中に書き込みが行われないようにします。この手順により、アップグレードの一貫性が保証されます。
- すべてのクラスター ノードの Kubernetes とその他のインフラストラクチャ コンポーネントをアップグレードします。
- オフライン インストールの場合は、プライベート Docker レジストリを新しいコンテナー イメージでハイドレートします。
- クラスターのファブリック コンポーネントと共有コンポーネントをアップグレードします。
- サービス (UiPath 製品) をアップグレードします。
- クラスターのメンテナンス モードを無効化し、クラスターを元に戻します。
このマトリクスでは、Automation Suite のバージョンで利用可能なアップグレード パスが示されています。
- メジャー バージョン間の直接のインプレース アップグレード パスが利用可能です。
- 元のメジャー バージョンとアップグレード先のメジャー バージョンの間で中間インプレース アップグレードを行う必要があります。
Automation Suite の最新のマイナー バージョンにアップグレードすることを強くお勧めします。 これにより、最新の機能強化を活用し、すべての内部コンポーネントのシームレスな動作を保証できます。
初期バージョン |
対象バージョン | ||||
---|---|---|---|---|---|
2021.10.x |
2022.4.x |
2022.10.x |
2023.4.x |
2023.10.x | |
2021.10.x |
|
2022.4.7-2022.4.10 にアップグレードしてから、2022.4.11 以降にアップグレードする必要があります。 |
まず 2022.10.0-2022.10.9 にアップグレードしてから、2022.10.10 以降にアップグレードする必要があります。 |
まず 2022.10.0-2022.10.9 にアップグレードしてから、2023.4.x にアップグレードする必要があります。 |
まず 2022.10.0-2022.10.9 にアップグレードしてから、2023.10.x にアップグレードする必要があります。 |
2022.4.x |
N/A |
|
現在のバージョンが 2022.4.0-2022.4.6 の場合、まず 2022.10.0-2022.10.9 にアップグレードしてから、2022.10.10 以降にアップグレードする必要があります。 現在のバージョンが 2022.4.7 以降の場合、2022.10.10 以降にアップグレードする必要があります。 |
現在のバージョンが 2022.4.0-2022.4.10 の場合、まず 2022.10.0-2022.10.9 にアップグレードしてから、2023.4.x にアップグレードする必要があります。 現在のバージョンが 2022.4.11 の場合、まず 2022.10.10 にアップグレードしてから、2023.4.5 にアップグレードする必要があります。 |
アップグレードを開始する前に、RAW デバイス上で 2022.4.7 以上の Ceph を使用し、Cilium の移行を完了する必要があります。 現在のバージョンが 2022.4.7-2022.4.10 の場合は、2023.10.x にアップグレードできます。 現在のバージョンが 2022.4.11 の場合、2023.10.2 以降にアップグレードする必要があります。 |
2022.10.x |
N/A |
N/A |
|
現在のバージョンが 2022.10.0-2022.10.9 の場合、2023.4.x にアップグレードできます。 現在のバージョンが 2022.10.10 以降の場合、2023.4.5 以降にアップグレードする必要があります。 |
現在のバージョンが 2022.10.0-2022.10.9 の場合、2023.10.x にアップグレードできます。 現在のバージョンが 2022.10.10 以降の場合、2023.10.2 以降にアップグレードする必要があります。 |
2023.4.x |
N/A |
N/A |
N/A |
|
現在のバージョンが 2023.4.0-2023.4.4 の場合、2023.10.x にアップグレードできます。 現在のバージョンが 2023.4.5 以降の場合、2023.10.2 以降にアップグレードする必要があります。 |
2023.10.x |
N/A |
N/A |
N/A |
N/A |
|
-
場合によっては、Automation Suite のアップグレードにおいて、内部コンポーネントの円滑な機能を維持するために、中間バージョンに移行するか、一部のバージョンを完全にスキップする必要があります。 前の表のアップグレード ガイドラインに従っていないと、内部コンポーネントのダウングレードまたは内部コンポーネントのアップグレードに失敗し、Automation Suite のアップグレードが失敗する可能性があります。
-
Process Mining が有効化されている Automation Suite v2022.10 以前からアップグレードする場合は、アップグレードを開始する前にプロセス アプリを新しいプロセス グラフ レイアウトに移行する必要があります。
-
Active Directory (AD) を使用していて、v2023.4.0 へのアップグレードを計画している場合は、v2023.4.0、v2023.4.1、v2023.4.2 が AD の問題の影響を受けているため、スキップして v2023.4.3 にアップグレードすることを強くお勧めします。
-
Automation Suite 2023.10 以降へのアップグレードでのみ、簡易アップグレード プロセスを利用できます。