- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 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 サポート バンドルを使用する
- ログを確認する
High Availability Add-on の構成
同一クラスターおよび外部マシンをデプロイするための Automation Suite の High Availability Add-on 構成オプションのリファレンス。
Automation Suite は、同じクラスターへのインストールでも、外部マシンへのインストールでも、High Availability Add-on (HAA) をサポートします。
マルチノード設定用に実際の HA 設定を有効化するには、HAA を構成する必要があります。そのためには、インストーラーに HAA ライセンスを提供するか、HAA を外部マシンにインストールして、HAA の構成をインストーラーに提供します。
クラスター内の Redis High Availability Add-on の構成
マルチ ノードの高可用性に対応した運用環境のセットアップでは、高可用性 (HA) が既定で有効化されます。ただし、クラスター サービスが使用する Redis ベースのインメモリ キャッシュはシングル ノードで実行されるため、単一障害点となります。したがって、High Availability Add-on (HAA) ライセンスを購入していない場合、キャッシュ ノードの障害や再起動によってクラスター全体のダウンタイムが発生します。
このような事態を防ぐには、HAA を購入すれば、冗長化されたマルチ ノードの高可用性対応の運用環境にキャッシュをデプロイできます。
すべてのインストールに、シングルノード ライセンスを伴う HAA ソフトウェアが付属しています。このライセンスは無料で、購入は不要です。
複数のノードで HAA を有効化する場合は、HAA ライセンスの購入が必要になります。ライセンスを購入することで、マルチノードの HA 対応の運用環境の設定のクラスターに高可用性の全機能が実装されます。
HAA は Redis 技術に基づいています。
そのためには、以下の手順に従ってください。
- HAA ライセンスを購入します。詳細については、UiPath® までお問い合わせください。
cluster_config.jsonファイルの、以下のフィールドを更新します。fabric.redis.license- 単一の Base64 文字列に変換して、HAA ライセンスを入力します。ライセンス キー全体を Base64 にエンコードする必要があります (テキスト-----LICENSE START----- and -----LICENSE END-----を含む)。bash では、次のコマンドを使用してこれを行うことができます。echo '-----LICENSE START-----<license_key_here>-----LICENSE END-----' | base64 -w0echo '-----LICENSE START-----<license_key_here>-----LICENSE END-----' | base64 -w0fabric.redis.ha-trueを使用して HAA を有効化し、fabric.redis.licenseパラメーターも構成します。これにより、HAA データベースのレプリケーションが有効化され、HAA ポッドの数が 3 まで増えます。既定でfabric.redis.haはfalseに設定されます。注:redis.haが有効な場合、redis.licenseは 3 つ以上のシャードをサポートするライセンスに設定する必要があります。"fabric": { "redis": { "ha": "true", "license": "Base64String" // Replace Base64String with the encoded full license string. } }"fabric": { "redis": { "ha": "true", "license": "Base64String" // Replace Base64String with the encoded full license string. } }
- ファブリック インストーラーを再実行します。
./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement
Redis ライセンスを更新する
Redis ライセンスを更新するには、次の手順に従います。
-
kubectl と ArgoCD へのアクセスを設定します。
- プライマリ ノードで kubectl アクセスを有効化します。手順については、「 kubectl を有効化 する」をご覧ください。
- ArgoCD へのアクセスを有効化します。手順については、「 ArgoCD にアクセスする 」をご覧ください。
-
現在のライセンス ステータスを確認します。
現在のライセンスのステータスを確認するには、次のシェル コマンドを実行します。
kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jqkubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq- インストーラーに含まれるライセンスの有効期限が切れた後にデプロイされたクラスターには、次の例のように、30 日間で有効期限が切れる無料トライアルの 4 シャードのライセンスが表示されます。
- ライセンスの有効期限が切れたときに既に実行されていたクラスターには、次のステータスが表示されます。
-
既存のライセンスを更新します。
-
既存のライセンスを更新するには、次のシェル コマンドを実行します。
kubectl patch application fabric-installer -n argocd \ --type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'kubectl patch application fabric-installer -n argocd \ --type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]' -
変更が適用されたかどうかを確認するには、ArgoCD にアクセスします。手順については、「 ArgoCD にアクセスする 」をご覧ください。
-
ファブリック インストーラー アプリケーションが同期されていないように見え、同期プロセスが自動的にトリガーされなかった場合は、自分で [同期] ボタンを選択します。これは、古いバージョンの Automation Suite を使用している場合に発生することがあります。
注:ArgoCD UI にアプリが同期されたことが表示されてから、Redis Operator が新しいライセンスを正常に適用するまでに、少し時間がかかる場合があります。
-
ライセンスを適用しようとしたときの Redis Operator のログを表示するには、次のコマンドを実行します。
kubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep licensekubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep license -
期限切れのライセンスを適用しようとした場合や、期限切れのライセンスが付属するインストーラーを実行した場合、次の出力が表示されます。
-
古いインストーラーで使用されている Redis ライセンスをインストーラーの実行前に更新するには、
<installer_folder>/defaults.jsonのfabric.redis.licenseキーを更新します。
-
-
新しいライセンスが適用されていることを確認します。
新しいライセンスが適用されているかどうかを確認するには、次のシェル コマンドを実行します。
kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jqkubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq以下の図は、Redis クラスターが無料トライアルの 30 日間のライセンスから、単一シャードの 10 年間のライセンスに切り替わっていることがわかります。
外部 High Availability Add-on の構成
Automation Suite のアクティブ/アクティブ構成を選択する場合、外部クラスターでホストされる High Availability Add-on が必須です。他のすべての状況では、これはオプションです。
High Availability Add-on を構成するには、 cluster_config.json ファイルで以下のパラメーターを更新する必要があります。
| パラメーター | 説明 |
|---|---|
|
| High Availability Add-on (HAA) サーバーの FQDN を指定します。 |
|
| HAA サーバーに接続するためのパスワードを入力します。 |
|
| HAA サーバーのポートを指定します。 |
fabric.redis.tls | TLS プロトコルを有効化します。既定では、TLS は有効化されています。 TLS が有効化されている場合に証明書が必要なときは、必ず |
"fabric": {
"redis": {
"hostname": "redis_fqdn",
"password": "credential_to_connect_redis",
"port": 6380,
"tls": true,
}
}
"fabric": {
"redis": {
"hostname": "redis_fqdn",
"password": "credential_to_connect_redis",
"port": 6380,
"tls": true,
}
}