- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn のスナップショットを自動的にクリーンアップする方法
- TX チェックサム オフロードを無効化する方法
- TLS 1.2 で弱い暗号に対処する方法
- 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 のメトリックが監視ダッシュボードに表示されない
- プロキシ環境でポッドが FQDN と通信できない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドルを使用する
- ログを確認する
手動、オフライン: クラスターを復元する
はじめる前に
-
Make sure you meet the Prerequisites.
-
Make sure the backup is disabled on the backup cluster. Inconsistencies will occurs if a new backup is created while cluster restore is in progress. See Disabling the backup on the cluster.
-
すべての復元ノードで、パッケージの wget、unzip、jq を使用できることを確認してください。
-
外部データソースは、すべて同じ (SQL Server) である必要があります。
-
クラスター復元の前に NFS サーバーを再起動してください。NFS サーバー ノードで、コマンド
systemctl restart nfs-serverを実行します。 -
復元クラスターは、バックアップ クラスターと同じ FQDN である必要があります。
インストールの種類 構成手順 要件 オフラインのシングルノードの評価モード
以下のファイルをダウンロードします。
sf-installer.zip– Mandatory. See sf-installer.zip for download instructions.sf-infra.tar.gz– Mandatory. See sf-infra.tar.gz for download instructions.
オフラインのマルチノードの高可用性対応の運用環境モード
以下のファイルをダウンロードします。
sf-installer.zip– Mandatory. See sf-installer.zip for download instructions.sf-infra.tar.gz– Mandatory. See sf-infra.tar.gz for download instructions.
復元操作を準備する
クラスターに複数のノードがある場合は、すべてのノードで次の手順に従います。
-
任意のマシンにログインします。
-
/opt/UiPathAutomationSuiteフォルダーを作成するために、以下を実行します。# Become root sudo su - # Replace {version} with actual installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer chmod -R 777 /opt/UiPathAutomationSuite# Become root sudo su - # Replace {version} with actual installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer chmod -R 777 /opt/UiPathAutomationSuite -
To copy
restore.jsonand other installer files to the/opt/UiPathAutomationSuite/{version}folder, run the following command. For details, see Preparing the restore configuration.# Replace {version} with actual installer version cp /path/to/restore.json /opt/UiPathAutomationSuite/${version}/installer cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/${version}/installer cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/${version}# Replace {version} with actual installer version cp /path/to/restore.json /opt/UiPathAutomationSuite/${version}/installer cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/${version}/installer cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/${version} -
sf-installer.zipを解凍するために、以下を実行します。# Navigate to installer folder. Replace {version} with actual installer version cd /opt/UiPathAutomationSuite/${version}/installer unzip sf-installer.zip -d .# Navigate to installer folder. Replace {version} with actual installer version cd /opt/UiPathAutomationSuite/${version}/installer unzip sf-installer.zip -d .
Restoring Etcd on the First Server Node
クラスターの最初のノードで etcd を復元するには、以下を実行します。
./install-uipath.sh -i restore.json -o output.json -r --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
./install-uipath.sh -i restore.json -o output.json -r --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
このコマンドは、最初のサーバー ノードのみのノード構成を復元します。
残りのサーバー ノードで etcd を復元する
クラスターの他のサーバー ノードで etcd を復元するには、以下を実行します。
./install-uipath.sh -i ../restore.json -o output.json -r -j server --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
./install-uipath.sh -i ../restore.json -o output.json -r -j server --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
このコマンドは、残りのサーバー ノードのノード構成を復元します。
エージェント ノードで etcd を復元する
クラスターのエージェント ノードで etcd を復元するには、以下を実行します。
./install-uipath.sh -i restore.json -o output.json -r -j agent --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
./install-uipath.sh -i restore.json -o output.json -r -j agent --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
このコマンドは、残りのエージェント ノードのノード構成を復元します。
Task Mining ノードで etcd を復元する
クラスターの Task Mining エージェント ノードで etcd を復元するには、以下を実行します。
./install-uipath.sh -i restore.json -o output.json -r -j task-mining --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
./install-uipath.sh -i restore.json -o output.json -r -j task-mining --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
このコマンドは、Task Mining ノードのノード構成を復元します。
GPU ノードで etcd を復元する
Before restoring the GPU machine, make sure you have followed Installing a GPU driver on the machine.
クラスターの GPU エージェント ノードで etcd を復元するには、以下を実行します。
./install-uipath.sh -i restore.json -o output.json -r -j gpu --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
./install-uipath.sh -i restore.json -o output.json -r -j gpu --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline
このコマンドは、残りの GPU ノードのノード構成を復元します。
メンテナンス モードを無効化する
この手順が必要になるのは、アップグレード中のロールバック操作に復元が含まれる場合のみです。
ボリュームを復元する前に、メンテナンス モードを無効化する必要があります。
./configureUiPathAS.sh disable-maintenance-mode
./configureUiPathAS.sh disable-maintenance-mode
任意のサーバー ノードでボリュームの復元を実行する
etcd の復元が完了した後で、以下を実行して、任意のサーバー ノードでボリュームを復元します。
\./install-uipath.sh -i restore.json -o output.json -r --volume-restore --accept-license-agreement --install-type offline
\./install-uipath.sh -i restore.json -o output.json -r --volume-restore --accept-license-agreement --install-type offline
このコマンドは、クラスターのボリューム データを復元します。
復元したクラスターで AI Center を有効化する
After restoring an Automation Suite cluster with AI Center™ enabled, follow the steps from the Enabling AI Center on the Restored Cluster procedure.
Cluster_config.json を復元する
Automation Suite クラスターの回復後、今後のために cluster_config.json を回復することもできます。クラスターに新しいノードを追加する際やアップグレードをする際に、このファイルが必要になることがあります。
cluster_config.json を復元するには、任意のサーバー ノードから次のコマンドを実行します。
./configureUiPathAS.sh config get -o ./cluster_config.json
./configureUiPathAS.sh config get -o ./cluster_config.json
The backup is not enabled on the restored cluster. If you want to enable the backup, refer to Enabling the backup on the cluster.
信頼ストアに CA 証明書を追加する
クラスターの復元後、復元した仮想マシンの信頼ストアに CA 証明書を追加してください。詳しくは、以下のページをご覧ください。