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

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

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

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

• UiPath.OrganizationMigrationApp を実行する前に、.NET ランタイム 6.0 をダウンロードしてインストールしてください。詳しくは、「 移行の前提条件」をご覧ください。
• UiPath.OrganizationMigrationApp をダウンロードするには、「 移行の前提条件」をご覧ください。

注:

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

このセクションでは、Uipath.Organization.Migration.App ツールを使用して実行する必要がある一般的な操作について説明します。Uipath.Organization.Migration.App ツールでサポートされているパラメーターについて詳しくは、「 移行ツールのパラメーター」をご覧ください。

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

  ./UiPath.OrganizationMigrationApp migrate -m -i '<restored & upgraded identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<restored & upgraded 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'
  

  複数のスタンドアロン テナントを 1 つの Automation Suite 組織に移行する際のユーザーの競合に対処する方法については、「」をご覧ください。

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

  ./UiPath.OrganizationMigrationApp migrate -m -r -i '<restored & upgraded identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<restored & upgraded 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 で移行ツールを実行する

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

• UiPath.OrganizationMigrationApp を実行する前に、.NET ランタイム 6.0 をダウンロードしてインストールする必要があります。詳しくは、「 移行の前提条件」をご覧ください。
• UiPath.OrganizationMigrationApp をダウンロードするには、「 移行の前提条件」をご覧ください。

注:

UiPath.OrganizationMigrationApp ツールを正常に実行するには、SQL パスワードに特殊文字が含まれている場合、エスケープする必要があります。たとえば、すべての $ を \`$ に置き換えます。接続文字列パスワードに含まれる特殊文字をエスケープする方法に関するガイドラインの詳細については、「接続文字列パスワードに含まれる特殊文字のエスケープ ルール」をご覧ください。

このセクションでは、Uipath.Organization.Migration.App ツールを使用して実行する必要がある一般的な操作について説明します。Uipath.Organization.Migration.App ツールでサポートされているパラメーターについて詳しくは、「 移行ツールのパラメーター」をご覧ください。

• すべてのテナントの 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'
  

  複数のスタンドアロン テナントを 1 つの Automation Suite 組織に移行する際のユーザーの競合に対処する方法については、「」をご覧ください。

  ./UiPath.OrganizationMigrationApp migrate -m -i "<restored & upgraded identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<restored & upgraded 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 "<restored & upgraded identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<restored & upgraded 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 が同じデータベースを使用している場合は、そのデータベースの接続文字列を使用します。
スタンドアロン製品の組織 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