手順 1: ID 組織のデータをスタンドアロンから Automation Suite に移動する

スタンドアロンと Automation Suite のバージョンは同じである必要があります。バージョンが異なる場合、データベース スキーマの競合の問題により移行が失敗します。互換性の問題が発生した場合は、スタンドアロンと Automation Suite のインストールを最新バージョンにアップグレードしてください。

Linux で移行ツールを実行する

開始する前に、以下の点を考慮してください。

• Make sure you download and install .NET Runtime 6.0 before running UiPath.OrganizationMigrationApp. For details, see Migration prerequisites.
• To download UiPath.OrganizationMigrationApp, see Migration prerequisites.

注:

必ず、選択したシェル ツールの一般的なエスケープ手順に従ってください。たとえば、Bash では、特殊文字の前に \ を追加する必要があります。

This section describes some common operations that you may need to perform using the Uipath.Organization.Migration.App tool. For details on the parameters that the Uipath.Organization.Migration.App tool supports, see Migration tool parameters.

• すべてのテナントの 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 tenant 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 を必ず追加してください。

  • Automation Suite のテナント名は、スタンドアロン Orchestrator の元のテナント名と同じです。 これは、スタンドアロン製品の移行先のテナントです。

  • すべてのテナントに対して、1 つのスタンドアロン テナントを 1 つの Automation Suite 組織に移行する場合、すべての移行に対して コマンドを 1 回実行できます。ただし、複数のスタンドアロン テナントを 1 つの Automation Suite 組織に移行する場合は、テナント間でのユーザーの競合の解決が必要になる場合があるため、テナントごとに個別にコマンドを実行する必要があります。次のサンプルは、テナントごとにコマンドを個別に実行する方法を示しています。

    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'
    

    For instructions on how to address user conflicts when migrating multiple standalone tenants to a single Automation Suite organization, see Solving user conflicts.

• 操作が途中で失敗した場合は、次のコマンドを実行して変更をロールバックします。

  ./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 tenant 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)"}
    

  • 次のエラー メッセージは、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.
    

  • 次のエラー メッセージは、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"}
    

  • 以下のエラー メッセージは、Automation Suite の組織内に、スタンドアロンのテナント名と同じテナント名のテナントが既に存在することを意味します。 競合を解決するには、Automation Suite 組織内のテナントのテナント名を変更する必要があります。

    Source tenant ID: 38f03b05-3aab-422c-844b-bf3668fa54ee, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenan1
    Source tenant ID: b35020b1-ee9f-4026-abd1-bb721b148e24, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenant2
    Tenant name conflicts detected. You need to rename the tenant to be a different name than conflict tenant name in target organization to unblock tenant creation.
    

Windows で移行ツールを実行する

開始する前に、以下の要素を考慮してください。

• You must download and install .NET Runtime 6.0 before running UiPath.OrganizationMigrationApp. For details, see Migration prerequisites.
• To download UiPath.OrganizationMigrationApp, see Migration prerequisites.

注:

To successfully run the UiPath.OrganizationMigrationApp tool, you must escape your SQL password if it contains special characters. For example, replace every instance of $ with \$`. For more guidelines on how to escape special characters in connection string passwords, refer to Special character escape rules for connection string passwords.

This section describes some common operations that you may need to perform using the Uipath.Organization.Migration.App tool. For details on the parameters that the Uipath.Organization.Migration.App tool supports, see Migration tool parameters.

• すべてのテナントの ID データをスタンドアロンから Automation Suite に移動するには、ファイルを抽出して次のコマンドを実行します。

  注:

  • ソース SQL 接続と宛先 SQL 接続の両方の入力に対して TrustServerCertificate=True を必ず追加してください。

  • Automation Suite のテナント名は、スタンドアロン Orchestrator の元のテナント名と同じです。 これは、スタンドアロン製品の移行先のテナントです。

  • すべてのテナントに対して、1 つのスタンドアロン テナントを 1 つの Automation Suite 組織に移行する場合、すべての移行に対して コマンドを 1 回実行できます。ただし、複数のスタンドアロン テナントを 1 つの Automation Suite 組織に移行する場合は、テナント間でのユーザーの競合の解決が必要になる場合があるため、テナントごとに個別にコマンドを実行する必要があります。次のサンプルは、テナントごとにコマンドを個別に実行する方法を示しています。

    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'
    

    For instructions on how to address user conflicts when migrating multiple standalone tenants to a single Automation Suite organization, see Solving user conflicts.

  ./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 tenant 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 tenant 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)"}
    

  • 次のエラー メッセージは、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.
    

  • 次のエラー メッセージは、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"}
    

  • 以下のエラー メッセージは、Automation Suite の組織内に、スタンドアロンのテナント名と同じテナント名のテナントが既に存在することを意味します。 競合を解決するには、Automation Suite 組織内のテナントのテナント名を変更する必要があります。

    Source tenant ID: 38f03b05-3aab-422c-844b-bf3668fa54ee, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenan1
    Source tenant ID: b35020b1-ee9f-4026-abd1-bb721b148e24, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenant2
    Tenant name conflicts detected. You need to rename the tenant to be a different name than conflict tenant name in target organization to unblock tenant creation.
    

移行ツールのパラメーター

次の表では、Uipath.Organization.Migration.App ツールがサポートするパラメーターについて説明します。 これらのパラメーターは、Linux および Windows で使用できます。

パラメーター名	短い名前	説明
スタンドアロン製品の Identity データベース接続	i	スタンドアロン製品の Identity データベース接続です。Identity と Orchestrator が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。
Identity database connection of Automation Suite	j	Automation Suite の ID データベース接続です。
スタンドアロン製品の Orchestrator データベース接続	o	スタンドアロン製品の Orchestrator データベース接続です。Identity と Orchestrator が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。Identity と Orchestrator が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。
スタンドアロン製品の組織 ID のリスト	s	マージするスタンドアロン製品の組織 ID のリスト。orgId1,orgId2,...,orgId5 の形式を使用してください。 組織 ID リストのサイズは、スタンドアロン製品と Automation Suite の両方で同じである必要があります。 スタンドアロン製品の組織 ID のリストを取得するには、スタンドアロン データベースで次のコマンドを実行し、復元したデータベースで GlobalId を関連するパーティション/組織名とともに使用します。 SELECT * FROM [identity].[Partitions]
Automation Suite の組織 ID のリスト	d	Automation Suite の組織 ID のリスト。orgId1,orgId2,...,orgId5 の形式を使用してください。 組織 ID リストのサイズは、スタンドアロン製品と Automation Suite の両方で同じである必要があります。 Automation Suite の組織 ID のリストを取得するには、Automation Suite の SQL Server 上の AutomationSuite_Platform データベースで次のコマンドを実行します。 SELECT * FROM [identity].[Partitions]
ロールバック	r	変更のロールバックに使用するパラメーターです。
Automation Suite の URL	p	Automation Suite の URL です。例: https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/
OMS S2S のクライアント シークレット	c	OMS API を呼び出してテナントを作成するために使用するクライアント シークレットです。 Kubernetes シークレットから OMS S2S クライアント シークレットを取得するには、次のコマンドを実行します。 kubectl get secret identity-client-oms -n uipath -o "jsonpath={.data.OMSS2SClient\.ClientSecret}" | base64 -d