- 概要
- 要件
- インストール
- 前提条件の確認
- インストール パッケージをダウンロードする
- uipathctl cluster
- uipathctl cluster maintenance
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- uipathctl cluster upgrade
- uipathctl config
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- uipathctl config alerts
- uipathctl config alerts add-email
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- uipathctl config orchestrator
- uipathctl config orchestrator get-config
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- uipathctl health
- uipathctl health bundle
- uipathctl health check
- uipathctl health diagnose
- uipathctl health test
- uipathctl manifest
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- uipathctl manifest list-applications
- uipathctl manifest list-revisions
- uipathctl manifest render
- uipathctl prereq
- uipathctl prereq create
- uipathctl prereq run
- uipathctl resource
- uipathctl resource report
- uipathctl snapshot
- uipathctl snapshot backup
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- uipathctl version
- インストール後
- 移行とアップグレード
- 監視とアラート機能
- クラスターの管理
- 製品固有の設定
- トラブルシューティング
手順 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 に再び移動するよう試みます。
-
前のコマンドを実行すると、ランダムな文字
tenant_xxxxxxxx
という名前の新しいテナントが作成されます。xxxxxxxx
はランダムな文字です。 これは、スタンドアロン製品の移行先のテナントです。