- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベストプラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バンドルに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn スナップショットを自動的にクリーンアップする方法
- NIC チェックサムオフロードを無効にする方法
- 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 メトリックが表示されない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドル ツールを使用する
- ログを確認する
手順 1: ID 組織のデータをスタンドアロンから Automation Suite に移動する
スタンドアロンと Automation Suite のバージョンは同じである必要があります。バージョンが異なる場合、データベース スキーマの競合の問題により移行が失敗します。互換性の問題が発生した場合は、スタンドアロンと Automation Suite のインストールを最新バージョンにアップグレードしてください。
UiPath.OrganizationMigrationApp を実行する前に、.NET ランタイム 6.0 をダウンロードしてインストールしてください。詳しくは、「移行の前提条件」をご覧ください。
UiPath.OrganizationMigrationApp をダウンロードするには、「移行の前提条件」をご覧ください。
\
を追加する必要があります。
UiPath.OrganizationMigrationApp ツールは、次のパラメーターをサポートしています。
パラメーター名 |
短い名前 |
説明 |
---|---|---|
スタンドアロン製品の Identity データベース接続 |
|
スタンドアロン製品の Identity データベース接続です。Identity と Orchestrator が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。 |
Identity database connection of Automation Suite |
| Automation Suite の ID データベース接続です。 |
スタンドアロン製品の Orchestrator データベース接続 |
| スタンドアロン製品の Orchestrator データベース接続です。Identity と Orchestrator が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。Identity と Orchestrator が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。 |
スタンドアロン製品の組織 ID のリスト | s |
マージするスタンドアロン製品の組織 ID のリスト。
orgId1,orgId2,...,orgId5 の形式を使用してください。
スタンドアロン製品と Automation Suite の両方の組織 ID リストのサイズは同じである必要があります。 スタンドアロン製品の組織 ID のリストを取得するには、スタンドアロン データベースで次のコマンドを実行し、復元したデータベースで
GlobalId を関連するパーティション/組織名とともに使用します。
|
Automation Suite の組織 ID のリスト | d |
Automation Suite の組織 ID のリスト。
orgId1,orgId2,...,orgId5 の形式を使用してください。
スタンドアロン製品と Automation Suite の両方の組織 ID リストのサイズは同じである必要があります。 Automation Suite の組織 ID のリストを取得するには、Automation Suite SQL サーバー上の
AutomationSuite_Platform データベースで次のコマンドを実行します。
|
ロールバック |
| 変更のロールバックに使用するパラメーターです。 |
Automation Suite の URL |
|
Automation Suite の URL です。例:
https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/ |
OMS S2S クライアント シークレット |
|
OMS API を呼び出してテナントを作成するために使用されるクライアント シークレットです。 Kubernetes シークレットから OMS S2S クライアント シークレットを取得するには、次のコマンドを実行します。
|
実行する必要がある一般的な操作を次に示します。
-
すべてのテナントの Identity データをスタンドアロンから Automation Suite に移動するには、ファイルを抽出して次のコマンドを実行します。
./UiPath.OrganizationMigrationApp migrate -m -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'
./UiPath.OrganizationMigrationApp migrate -m -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'注:入力内のすべての SQL 接続に対してTrustServerCertificate=True
を必ず追加してください。 -
操作が途中で失敗した場合は、次のコマンドを実行して変更をロールバックします。
./UiPath.OrganizationMigrationApp migrate -m -r -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'
./UiPath.OrganizationMigrationApp migrate -m -r -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>' -
エラー メッセージに基づいて問題を修正し、すべてのテナントの Identity データをスタンドアロンから Automation Suite に再び移動するよう試みます。たとえば、次のエラー メッセージとその意味を参照してください。
-
次のエラー メッセージは、テナントが既に作成されており、テナントの作成がスキップされることを意味します。 何もする必要はありません。
Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"}
Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"} -
次のエラー メッセージは、Automation Suite の URL が無効であることを意味します。 必ず正しい Automation Suite URL を指定してください。
Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com. ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443) ---> System.Net.Sockets.SocketException (11001): No such host is known.
Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com. ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443) ---> System.Net.Sockets.SocketException (11001): No such host is known. -
次のエラー メッセージは、OMS S2S クライアント シークレットが無効であることを意味します。 正しい OMS S2S クライアント シークレットを指定してください。
Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token Http Response Content:{"error":"invalid_client"}
Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token Http Response Content:{"error":"invalid_client"}
-
UiPath.OrganizationMigrationApp を実行する前に、.NET ランタイム 6.0 をダウンロードしてインストールしてください。詳しくは、「移行の前提条件」をご覧ください。
UiPath.OrganizationMigrationApp をダウンロードするには、「移行の前提条件」をご覧ください。
$
を \`$
に置き換えます。接続文字列パスワードに含まれる特殊文字をエスケープする方法に関するガイドラインの詳細については、「接続文字列パスワードに含まれる特殊文字のエスケープ ルール」をご覧ください。
実行する必要がある一般的な操作を次に示します。
-
すべてのテナントの ID データをスタンドアロンから Automation Suite に移動するには、ファイルを抽出して次のコマンドを実行します。注:ソース SQL 接続と宛先 SQL 接続の両方の入力に対して
TrustServerCertificate=True
を必ず追加してください。./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"
./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>" -
操作が途中で失敗した場合は、次のコマンドを実行して変更をロールバックします。
./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"
./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>" -
エラー メッセージに基づいて問題を修正し、すべてのテナントの Identity データをスタンドアロンから Automation Suite に再び移動するよう試みます。
-
After running the previous command, a new tenant named
tenant_xxxxxxxx
is created, wherexxxxxxxx
are random characters. This is the tenant to which you will migrate the standalone products.