- 概要
- 要件
- 推奨: デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 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: インストールの前提条件を検証する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- Linux の Automation Suite から EKS/AKS の Automation Suite に移行する
- Automation Suite をアップグレードする
- 製品固有の設定
- ベストプラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- 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 サポート バンドル ツールを使用する
- ログを確認する
Automation Suite をアップグレードする
-
Automation Suite 2023.4.5 および 2023.10.2 には、Kubernetes 1.26.11 へのアップグレードが含まれています。 そのため、Automation Suite をアップグレードする際は Kubernetes をダウングレードしないようにする必要があります。 そのためには、Automation Suite 2023.4.5 以降のマイナー バージョンから次のメジャー バージョンに移行する際に、少なくとも 2023.10.2 にアップグレードする必要があります。
-
Automation Suite 2022.10 からアップグレードする場合は、2023.4 以降に直接アップグレードできます。しかし、Automation Suite 2021.10 または 2022.4 からアップグレードする場合は、まず 2022.10 にアップグレードしてから 2023.4 以降にアップグレードする必要があります。詳しくは、「Automation Suite のアップグレード パス」をご覧ください。
-
Automation Suite をアップグレードすると、クラスターでメンテナンス モードが有効化されるため、アップグレードの期間中ダウンタイムが発生します。
-
Process Mining が有効化されている Automation Suite v2022.10 以前からアップグレードする場合は、アップグレードを開始する前にプロセス アプリを新しいプロセス グラフ レイアウトに移行する必要があります。
-
FIPS 140-2 が無効化されたマシンにインストールされた Automation Suite バージョンからアップグレードする場合は、「セキュリティとコンプライアンス」に記載の手順に従って FIPS 140-2 を有効化できます。
-
新しい Automation Suite のバージョンのハードウェアおよびソフトウェアの要件を満たしていることを確認します。
-
Automation Suite のアップグレードのベスト プラクティスに従い、ニーズに最も合ったアップグレード プロセスを実行してください。
Automation Suite のインプレース アップグレード プロセスでは、同じハードウェア上で設定とデータを変更せずに、Automation Suite の新しいバージョンに移行できます。
-
インプレース アップグレード プロセスでは、まず Kubernetes とその他のインフラストラクチャ コンポーネントをアップグレードしてから、共有コンポーネントと UiPath® 製品サービスをアップグレードします。
-
アップグレード プロセス中に回復できないハード障害が発生した場合は、バックアップと復元機能を使用して以前のバージョンにロールバックする必要があります。
Automation Suite のサイドバイサイド アップグレードでは、エンタープライズ アップグレードのエクスペリエンスを活用します。このアップグレードは一般にブルー/グリーンと呼ばれ、業界全体で標準的なプロセスです。
-
サイドバイサイド アップグレードを使用すると、インプレース アップグレードではなく、並列環境を使用して安全にアップグレードを実行できます。
-
この方法を使用すると、管理者は新しいデプロイを確認した後に、古い Automation Suite クラスター (ブルー デプロイ) から新しい Automation Suite クラスター (グリーン デプロイ) にトラフィックを切り替えることができます。問題が検出された場合は、すぐに古いデプロイにロールバックできます。
機能 |
アップグレードのメカニズム | |
---|---|---|
インプレース アップグレード |
サイドバイサイド アップグレード | |
新しい LTS バージョンにアップグレードする |
|
|
サポートされているバージョンからのアップグレード |
1 |
2 |
忠実度の高いデータ移行 |
|
3 |
アップグレード中のダウンタイムなし |
|
|
即時ロールバック |
|
|
1 Automation Suite の任意のバージョンからアップグレードできますが、初期バージョンと対象バージョンの間で中間アップグレードが必要になる場合があります。詳しくは、「インプレース アップグレード パス」をご覧ください。
2 v2021.10 を除く任意のバージョンの Automation Suite からアップグレードできます。詳しくは、「サイド バイ サイド アップグレード パス」をご覧ください。
3 詳しくは、「データ移行と責任」をご覧ください。
このマトリクスでは、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 以降へのアップグレードでのみ、簡易アップグレード プロセスを利用できます。
次のマトリクスは、Automation Suite のバージョンで利用可能なサイドバイサイド アップグレード パスが示されています。
- バージョン間の直接のサイドバイサイド アップグレード パスが利用可能です。
- 初期バージョンと対象バージョンの間でサイドバイサイド アップグレードはできません。
Automation Suite の最新のマイナー バージョンにアップグレードすることを強くお勧めします。 これにより、最新の機能強化を活用し、すべての内部コンポーネントのシームレスな動作を保証できます。
初期バージョン |
対象バージョン | ||||
---|---|---|---|---|---|
2021.10.x |
2022.4.x |
2022.10.x |
2023.4.x |
2023.10.x | |
2021.10.x |
|
|
|
|
|
2022.4.x |
N/A |
|
|
|
|
2022.10.x |
N/A |
N/A |
|
|
|
2023.4.x |
N/A |
N/A |
N/A |
|
|
2023.10.x |
N/A |
N/A |
N/A |
N/A |
|
追加の環境を使用してアップグレードを実行できる場合は、より安全なアップグレード アプローチと即時ロールバックを提供するサイドバイサイド アップグレード パスを選択することをお勧めします。
アップグレードを実行するための追加の環境を使用できない場合は、インプレース アップグレードを選択できます。必ず、アップグレード検証のベスト プラクティスに従ってください。
インプレース アップグレードとサイドバイサイド アップグレードのどちらを使用する場合でも、類似する 2 つの Automation Suite 環境を準備することをお勧めします。
-
開発または QA 用の Automation Suite マルチノード クラスター
注: 開発/QA 環境は、アップグレードの検証以外に使用しない場合、常にオンラインである必要はありません。 -
運用環境用の Automation Suite マルチノード クラスター
Automation Suite をアップグレードする前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。
クラスターのデータは NFS サーバー上にバックアップされます。続行する前に、必ず NFS サーバーを構成してください。
構築したオートメーションを検証するには、Automation Suite の運用環境で直接、個別の組織またはテナントを作成します。これが最もコスト効率の高いソリューションです。ベスト プラクティスの詳細については、「Orchestrator - オートメーションのベスト プラクティス」をご覧ください。
異なる環境やバージョンでオートメーションを検証するには、新しい Automation Suite クラスターをインストールした後、運用環境でトラフィックを新しいクラスターに切り替える前に、2 つ目の Automation Suite クラスターを活用します。