- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 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: インストールの前提条件を検証する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- Ceph の読み取り専用モードから移行する
- 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 でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策によりインストールと操作に問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- サポート バンドルのログ収集の失敗
- Test Automation SQL の接続文字列は無視されます
- DNS 設定が CoreDNS によって受け入れられない
- Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる
- シングルノードのアップグレードがファブリック ステージで失敗する
- Ceph の異常によりアップグレードが失敗する
- ボリュームがマウントできず、アタッチ/デタッチ ループ状態のまま
- 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 サーバーの起動に失敗する
- 初回インストール後に ArgoCD が進行中ステートになる
- 手動による ArgoCD ネットワーク ポリシーの軽減策 (GHSA-47m3-95c7-g2g8)
- クラスターの復元またはロールバック後にサービスが異常になる
- 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 サポート バンドルを使用する
- ログを確認する
クラスター スナップショットのバックアップを構成する
Automation Suite でクラスター スナップショットのバックアップを構成するためのリファレンス (ストレージの場所、前提条件、スケジュール管理など)
クラスター スナップショットを構成する
クラスターを構成する前に、スケジュールされたスナップショットを無効化してください。スナップショットの構成が終わったら、スケジュールを再度有効化できます。
前提条件:
- 必ずスナップショットの保存場所を設定してください。
クラスター スナップショットを設定するには、以下の手順に従います。
- 任意のサーバー ノードにログインします。
- 次のコマンドを実行します。
cd /opt/UiPathAutomationSuite/<version>/installer ./configureUiPathAS.sh snapshot config -i cluster_config.jsoncd /opt/UiPathAutomationSuite/<version>/installer ./configureUiPathAS.sh snapshot config -i cluster_config.json
利用可能なフラグを表示するには、前のコマンドに -h を追加します。
以下の表に、利用可能なフラグとその使用方法のリストを示します。
| 構成フラグ | 説明 | 使用すべきタイミング | 既定値 |
|---|---|---|---|
-i、 --input (必須) | 入力ファイルを復元します。 | バックアップを復元する | N/A |
-s、 --schedule (任意) | スナップショットのスケジュールを設定するための cron 式を指定します。 こちらをクリックすると、cron 式を試してみることができます。 | スナップショットのバックアップの場合のみ | */45 * * * *つまり、スナップショットは 45 分間隔で作成されます。たとえば、値 0 0 * * 2 を指定すると、毎週火曜日 00:00 にスナップショットのバックアップがトリガーされます。 |
-r、 --retention (任意) | スナップショットを保持する時間数を指定します。 | スナップショットのバックアップの場合のみ | 168 時間 (7 日) |
-t、 --target (必須) | スナップショットのバックアップの保存に使用するターゲットの種類を指定します。 | スナップショットのバックアップ バックアップの復元 | NFS。これがサポートされる種類です。 |
-e、 --endpoint (必須) | スナップショットの保存場所の FQDN または IP アドレスを指定します。 例: mynfs.mycompany.com または 192.23.222.81 | スナップショットのバックアップ バックアップの復元 | N/A |
-l、 --location (必須) | スナップショットの保存場所またはパスを指定します。 | スナップショットのバックアップ バックアップの復元 | N/A |
-p、 --prefix (任意) | スケジュールされているすべてのスナップショットのバックアップに付けるプレフィックスとして使用する文字列を指定します。 指定する文字列は小文字でなければなりません。 | N/A | schedule |
-h, --help | ヘルプを表示します。 | N/A | N/A |
-d, --debug | デバッグ モードで実行します。 | N/A | N/A |
例
./configureUiPathAS.sh snapshot config -s "*/45 * * * *" -r "48h" -t nfs -e 192.168.10.5 -l "/asbackup" --prefix "schedule"
./configureUiPathAS.sh snapshot config -s "*/45 * * * *" -r "48h" -t nfs -e 192.168.10.5 -l "/asbackup" --prefix "schedule"
--schedule パラメーターの一部として指定した cron 式は、クラスター ノードの時刻と一致します。外部データ ストア (SQL データベースや ObjectStore など) のスケジュールされたバックアップと cron 式を同期することをお勧めします。外部データ ストア (SQL データベースや ObjectStore など) のスケジュールされたバックアップと cron 式を同期することをお勧めします。
Automation Suite で保存されるスナップショットは、定義されている保持ポリシーの期間中にバックアップされたスナップショットのみです。保持ポリシーの期間が短い場合、保持ポリシーを適用すると重要なスナップショットが失われる可能性があります。同様に、保持ポリシーの期間が長い場合、保存されるスナップショットの数が増え、NFS サーバーの領域が占有される可能性があります。
スケジュールの設定は慎重に検討してください。短い間隔 (30 分など) でスナップショットを作成すると、バックアップ操作が頻繁に行われることになり、最後の 30 分間のデータを保存する必要があります。同様に、週に 1 回スナップショットを作成すると、前回のバックアップからかなり時間が経ってから障害が発生した場合にデータが失われる可能性があります。したがって、バックアップ スケジュールと保持期間は、回復ポイントの目標 (RPO) の要件に合わせることを強くお勧めします。
スナップショットのバックアップを有効化する
クラスター スナップショットのバックアップのスケジュールを有効化するには、次の手順に従います。
- 任意のサーバー ノードにログインします。
- スナップショットのバックアップを有効化します。
./configureUiPathAS.sh snapshot backup enable./configureUiPathAS.sh snapshot backup enable
- 新しいスナップショットのプレフィックスが既存のスナップショットで既に使用されている場合はエラーが発生します。エラーを防ぐには、前述のスナップショットを無効化して手順 2 でコマンドを再実行します。
- スケジュールされたバックアップがタイムアウトのために失敗し、アラート通知を受信した場合は、
--csi-snapshot-timeout 3hフラグを追加してタイムアウトを 3 時間に延長し、手順 2 のコマンドを再実行してください。
スナップショットのバックアップを無効化する
クラスター スナップショットの定期的なバックアップを無効化するには、以下の手順を実行します。
- 任意のサーバー ノードにログインします。
- 次のコマンドを実行します。
./configureUiPathAS.sh snapshot backup disable./configureUiPathAS.sh snapshot backup disable
無効化するバックアップが有効でない場合は、エラーが発生します。
スナップショットのオンデマンド バックアップ
スナップショットに基づいてバックアップを作成するには次の手順を実行します。
- 任意のサーバー ノードにログインします。
- バックアップを作成します。
./configureUiPathAS.sh snapshot backup create <backup name>./configureUiPathAS.sh snapshot backup create <backup name>
<backup name> を、バックアップに割り当てる一意の名前に置き換えます。
スナップショットのトリガーは非同期操作です。ただし、-wait フラグを追加すると、スナップショットのバックアップが完了するまで待機できます。
./configureUiPathAS.sh snapshot backup create <backup name> --wait
./configureUiPathAS.sh snapshot backup create <backup name> --wait
- 保持ポリシーではスナップショットのオンデマンド バックアップは削除されません。ストレージが不必要に消費されるのを避けるには、オンデマンド バックアップを手動で削除します。
- バックアップがタイムアウトのために失敗した場合は、
--csi-snapshot-timeout 3hフラグを追加してタイムアウトを 3 時間に延長し、手順 2 のコマンドを再実行してください。
既存のスナップショットの一覧を表示する
既存のバックアップとそのステータスを表示するには、以下の手順を実行します。
-
任意のサーバー ノードにログインします。
-
次のコマンドを実行します。
./configureUiPathAS.sh snapshot list./configureUiPathAS.sh snapshot listすべてのクラスター スナップショット (オンデマンドおよびスケジュール済み) のリストと、そのステータス、作成日時、有効期限が表示されます。
./configureUiPathAS.sh snapshot list NAME STATUS CREATION EXPIRATION manualbackup1 Completed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC manualbackup2 PartiallyFailed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC./configureUiPathAS.sh snapshot list NAME STATUS CREATION EXPIRATION manualbackup1 Completed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC manualbackup2 PartiallyFailed 2022-09-13 09:19:50 +0000 UTC 2023-09-13 09:19:50 +0000 UTC
バックアップを削除する
バックアップを削除すると、クラスター メタデータとボリューム データもバックアップ ストレージ サーバーから削除されます。この操作は元に戻せません。
バックアップ サーバーからスナップショットのバックアップを削除するには、次のコマンドを実行します。
./configureUiPathAS.sh snapshot delete -h
Delete the snapshot backup
Usage:
configureUiPathAS.sh snapshot delete (name | --all) [flags]
Flags:
-a, --all Delete all the snapshots
-f, --force Forcibly delete the snapshot without confirmation
-h, --help help for delete
./configureUiPathAS.sh snapshot delete -h
Delete the snapshot backup
Usage:
configureUiPathAS.sh snapshot delete (name | --all) [flags]
Flags:
-a, --all Delete all the snapshots
-f, --force Forcibly delete the snapshot without confirmation
-h, --help help for delete
例
指定したスナップショットを削除する
このコマンドは、ユーザーによる確認の後、指定されたスナップショットを削除します。
./configureUiPathAS.sh snapshot delete <snapshot name>
./configureUiPathAS.sh snapshot delete <snapshot name>
「 <snapshot name> 」を、削除するバックアップの名前に置き換えます。
指定したスナップショットを通知なしに削除する
このコマンドは、ユーザーに確認を求めることなくスナップショットを削除します。
./configureUiPathAS.sh snapshot delete <snapshot name> --force
./configureUiPathAS.sh snapshot delete <snapshot name> --force
<snapshot name> を、サイレント モードで削除するバックアップの名前に置き換えます。
すべてのスナップショットを削除する
このコマンドは、ユーザーによる確認の後、すべてのスナップショットを削除します。
./configureUiPathAS.sh snapshot delete --all
./configureUiPathAS.sh snapshot delete --all
すべてのスナップショットを通知なしに削除する
このコマンドは、ユーザーに確認を求めることなく既存のスナップショットをすべて削除します。
./configureUiPathAS.sh snapshot delete --all --force
./configureUiPathAS.sh snapshot delete --all --force