- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 2: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 3: 外部 ObjectStore を構成する
- 手順 4: High Availability Add-on を構成する
- 手順 5: SQL データベースを構成する
- 手順 6: ロード バランサーを構成する
- 手順 7: DNS を構成する
- 手順 8: ディスクを構成する
- 手順 9: カーネルと OS レベルの設定を構成する
- 手順 10: ノード ポートを構成する
- 手順 11: その他の設定を適用する
- 手順 12: 必要な RPM パッケージを検証してインストールする
- 手順 13: cluster_config.json を生成する
- 証明書の設定
- データベースの構成
- 外部 ObjectStore の構成
- 署名済み URL の構成
- Kerberos 認証の構成
- 外部の OCI 準拠レジストリの設定
- Disaster Recovery - アクティブ/パッシブおよびアクティブ/アクティブの構成
- 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 インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- TX チェックサム オフロードを無効化する方法
- Automation Suite 2022.10.10 および 2022.4.11 から 2023.10.2 にアップグレードする方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- AI Center のストレージを拡張する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- 証明書の操作方法
- アプリケーション ログを Splunk に転送する方法
- レジストリ ポッドから未使用の Docker イメージをクリーンアップする方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- サポート バンドルのログ収集の失敗
- Test Automation SQL の接続文字列は無視されます
- DNS 設定が CoreDNS によって受け入れられない
- Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる
- シングルノードのアップグレードがファブリック ステージで失敗する
- 2021.10 からの自動アップグレード後にクラスターが異常になる
- Ceph の異常によりアップグレードが失敗する
- 領域の問題のために rke2 が開始しない
- ボリュームがマウントできず、アタッチ/デタッチ ループ状態のまま
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- 異常な Insights コンポーネントが原因で移行が失敗する
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- Docker レジストリの移行が PVC の削除段階でスタックする
- v2023.10 以降へのアップグレード後に AI Center のプロビジョニングが失敗する
- オフライン環境でアップグレードが失敗する
- アップグレード中に SQL の検証が失敗する
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- Longhorn REST API エンドポイントのアップグレード/再インストール エラー
- 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 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初回インストール後に ArgoCD が進行中ステートになる
- クラスターの復元またはロールバック後にサービスが異常になる
- Init:0/X でポッドがスタックする
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- プロキシ環境でポッドが FQDN と通信できない
- アップグレード後にメール アラートを設定できない
- アップストリームに正常な問題はありません
- オフライン環境でエージェント ノードを追加できない
- FQDN にアクセスすると RBAC: アクセス拒否エラーが返されます
- Process Mining で高可用性を実行する
- Kerberos を使用してログインすると、Process Mining を取り込むことができなかった
- 障害復旧後、Dapr が Process Mining に対して正しく機能しない
- クラスター モードで Redis を使用した Dapr を構成する
- pyodbc 形式の接続文字列を使用して AutomationSuite_ProcessMining_Warehouse データベースに接続できない
- Airflow のインストールが「sqlalchemy.exc.ArgumentError: Could not parse rfc1738 URL from string ''」で失敗する
- SQL Server ポート 1433 を使用する IP テーブル ルールを追加する方法
- CData Sync を実行しているサーバーの Automation Suite の証明書が信頼されない
- 診断ツールを実行する
- Automation Suite サポート バンドルを使用する
- ログを確認する
- 要約されたテレメトリを確認する

Linux の 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 のアップグレード パス」をご覧ください。
- Process Mining が有効化されている Automation Suite v2022.10 以前からアップグレードする場合は、アップグレードを開始する前にプロセス アプリを新しいプロセス グラフ レイアウトに移行する必要があります。
- FIPS 140-2 が無効化されたマシンにインストールされた Automation Suite バージョンからアップグレードする場合は、「セキュリティとコンプライアンス」に記載の手順に従って FIPS 140-2 を有効化できます。
要件
- 新しい Automation Suite のバージョンの ハードウェアおよびソフトウェアの要件を満たしている ことを確認します。AI Center が有効化されている場合は、 CUDA の要件を満たしていることを確認してください。
- Automation Suite のアップグレードのベスト プラクティスに従い、ニーズに最も合ったアップグレード プロセスを実行してください。
アップグレード プロセス
Automation Suite では、次の 2 つのアップグレード プロセスがサポートされています。
- インプレース アップグレード
- サイドバイサイド アップグレード
インプレース アップグレード プロセス
Automation Suite のインプレース アップグレード プロセスでは、同じハードウェア上で設定とデータを変更せずに、Automation Suite の新しいバージョンに移行できます。
- インプレース アップグレード プロセスでは、まず Kubernetes とその他のインフラストラクチャ コンポーネントをアップグレードしてから、共有コンポーネントと UiPath® 製品サービスをアップグレードします。
- アップグレード プロセス中に回復できないハード障害が発生した場合は、バックアップと復元機能を使用して以前のバージョンにロールバックする必要があります。
サイドバイサイド アップグレード
Automation Suite のサイドバイサイド アップグレードでは、エンタープライズ アップグレードのエクスペリエンスを活用します。このアップグレードは一般にブルー/グリーンと呼ばれ、業界全体で標準的なプロセスです。
- サイドバイサイド アップグレードを使用すると、インプレース アップグレードではなく、並列環境を使用して安全にアップグレードを実行できます。
- この方法を使用すると、管理者は新しいデプロイを確認した後に、古い Automation Suite クラスター (ブルー デプロイ) から新しい Automation Suite クラスター (グリーン デプロイ) にトラフィックを切り替えることができます。問題が検出された場合は、すぐに古いデプロイにロールバックできます。
アップグレードのメカニズムと機能
| 機能 | アップグレードのメカニズム | |
|---|---|---|
| インプレース アップグレード | サイドバイサイド アップグレード | |
| 新しい LTS バージョンにアップグレードする | ✅ | ✅ |
| サポートされているバージョンからのアップグレード |
| ✅2 |
| 忠実度の高いデータ移行 | ✅ | ❌ 3 |
| アップグレード中のダウンタイムなし | ❌ | ❌ |
| 即時ロールバック | ❌ | ✅ |
| 追加のハードウェア要件はありません | ✅ | ❌ 4 |
1 Automation Suite の任意のバージョンからアップグレードできますが、初期バージョンと対象バージョンの間で中間アップグレードが必要になる場合があります。詳しくは、「インプレース アップグレード パス」をご覧ください。
2 v2021.10 を除く任意のバージョンの Automation Suite からアップグレードできます。詳しくは、「サイド バイ サイド アップグレード パス」をご覧ください。
3 詳しくは、「データ移行と責任」をご覧ください。
4 サイドバイサイド アップグレードには追加のハードウェアが必要です。ソース クラスターと同じ仕様の並列環境を利用するか、シングルノード クラスターに必要なハードウェアから始めてスケール アップすることができます。
インプレース アップグレード パス
このマトリクスでは、Automation Suite のバージョンで利用可能なインプレース アップグレード パスが示されています。
-
✅ - メジャー バージョン間の直接のインプレース アップグレード パスが利用可能です。
-
- 元のメジャー バージョンとアップグレード先のメジャー バージョンの間で中間インプレース アップグレードを行う必要があります。注:中間バージョンにアップグレードする必要がある場合は、中間バージョンをベース バージョンとして使用し、アップグレード パスに沿ってアップグレードを続行できます。
インプレース アップグレード パスは、Linux の Automation Suite に固有です。一方で、EKS/AKS の Automation Suite では、 Kubernetes の相互運用性を維持する必要があります。一方、OpenShift の Automation Suite では、 OpenShift との相互運用性を維持する必要があります。
Automation Suite の最新のマイナー バージョンにアップグレードすることを強くお勧めします。これにより、最新の機能強化を活用できるほか、すべての内部コンポーネントのシームレスな動作が保証されます。
| 初期バージョン | Linux の Automation Suite の対象バージョン | ||||
|---|---|---|---|---|---|
| 2022.10.x | 2023.4.x | 2023.10.x | 2024.10.x | 2.2510.x | |
| 2021.10.x | ✅
|
|
|
|
|
| 2022.4.x | ✅
|
| ✅ アップグレードを開始する前に、RAW デバイス上で 2022.4.7 以上の Ceph を使用し、Cilium の移行を完了する必要があります。
| アップグレードを開始する前に、RAW デバイス上で 2022.4.7 以上の Ceph を使用し、Cilium の移行を完了する必要があります。
|
|
| 2022.10.x | ✅
| ✅
| ✅
|
|
|
| 2023.4.x | N/A | ✅
| ✅
|
|
|
| 2023.10.x | N/A | N/A | ✅
| ✅
|
|
| 2024.10.x | N/A | N/A | N/A | ✅
| ✅
|
| 2.2510.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 サーバーを構成してください。
認証
以下の要件を同時に満たす場合は、必ず global.userInputs.identity.krb5KeytabSecret の値を global.kerberosAuthConfig.userKeytab にコピーしてください。
- Active Directory との連携を、ユーザー名とパスワードを使用して構成している。
- Windows 認証が有効化されている。
- SQL 統合認証を使用していない。
自動化の検証のベスト プラクティス
構築したオートメーションを検証するには、Automation Suite の運用環境で直接、個別の組織またはテナントを作成します。これが最もコスト効率の高いソリューションです。ベスト プラクティスの詳細については、「Orchestrator - オートメーションのベスト プラクティス」をご覧ください。
バージョン検証
異なる環境やバージョンでオートメーションを検証するには、新しい Automation Suite クラスターをインストールした後、運用環境でトラフィックを新しいクラスターに切り替える前に、2 つ目の Automation Suite クラスターを活用します。
ライセンス
Automation Suite を新しいバージョンにアップグレードする場合は、選択するアップグレード パスにかかわらず、追加のライセンスは必要ありません。ただし、UiPath のベスト プラクティスに従い、2 つの Automation Suite クラスター (1 つは QA/dev 用、もう 1 つは運用環境用) を使用する場合は、クラスターごとにライセンスが 1 つ必要です。