手順 5: 組織を Automation Suite にマージする

移行ツールの入力

UiPath.OrganizationMigrationApp ツールを実行する際は、以下の詳細情報を指定する必要があります。

• スタンドアロン製品の組織 ID のリスト

• Automation Suite の組織 ID のリスト

詳しくは、「 移行ツールのパラメーター」をご覧ください。

注:

「手順 1: ID 組織のデータをスタンドアロンから Automation Suite に移動する」で特定した組織 ID と同じ組織 ID を使用してください。

(Linux 用)

注:

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

組織を Automation Suite にマージするには、次のコマンドを実行します。

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s '<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>' -d '<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>'

注:

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

• マージする組織のペアが複数ある場合は、スタンドアロン製品の組織 ID のシーケンスと Automation Suite の組織 ID のシーケンスが一致することを確認してください。

• すべてのテナントについて、1 つのスタンドアロン テナントを 1 つの Automation Suite 組織に移行する場合、 すべての移行。 ただし、複数のスタンドアロン テナントを 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 組織に移行する際のユーザーの競合に対処する方法については、「」をご覧ください。

(Windows 用)

組織を Automation Suite にマージするには、次のコマンドを実行します。

./UiPath.OrganizationMigrationApp merge -i "<identity database connection of Automation Suite>" -o "<restored orchestrator DB in Automation Suite connection string>" -s "<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>" -d "<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>"

注:

• 入力内のソース SQL 接続文字列と宛先 SQL 接続文字列の両方に対して TrustServerCertificate=True を必ず追加してください。
• すべてのテナントについて、1 つのスタンドアロン テナントを 1 つの Automation Suite 組織に移行する場合、 すべての移行。 ただし、複数のスタンドアロン テナントを 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 組織に移行する際のユーザーの競合に対処する方法については、「」をご覧ください。

結合に関する期待

ユーザー

注:

Automation Suite への移行後は、スタンドアロンの Orchestrator にアクセスできるのは、スタンドアロンの Orchestrator を起源とするユーザーのみです。

次の表に、複数の移行シナリオと、それらがユーザーに与える影響についての洞察を示します。

条件	結合元のユーザーはメール アドレスを持っているか	結合先のユーザーはメール アドレスを持っているか	結合元のユーザーのメール アドレスは結合先のユーザーと同じか	結合元のユーザー名は結合先のユーザー名と同じか	結果
1					結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。
2					結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。 結合後、2 人のユーザーが同じユーザー名を持ち、そのメール アドレスを使用してログインする必要があります。
3				OR	結合元のユーザーは結合先のユーザーにマージされ、結合先のユーザーがスタンドアロンの Orchestrator にアクセスできます。
4			N/A		結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。
5			N/A		結合元のユーザーは結合先のユーザーにマージされ、結合先のユーザーがスタンドアロンの Orchestrator にアクセスできます。
6			N/A		結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。
7			N/A		結合先のユーザーのメール アドレスを手動で設定するか、結合先のユーザーを削除する必要があります。 メール アドレスを設定すると、結合元のユーザーは結合先のユーザーにマージされ、結合先のユーザーがスタンドアロンの Orchestrator にアクセスできます。 結合先のユーザーを削除すると、結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。
8			N/A		結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。
9			N/A		結合先のユーザーのメール アドレスを空に設定するか、結合先のユーザーを削除する必要があります。 メール アドレスを空に設定すると、結合元のユーザーは結合先のユーザーにマージされ、結合先のユーザーがスタンドアロンの Orchestrator にアクセスできます。 結合先のユーザーを削除すると、結合元のユーザーは結合先の組織に移動され、結合先の組織のユーザーがスタンドアロンの Orchestrator にアクセスできます。

ロボット ユーザー

結合元のロボット ユーザー名と結合先のロボットユーザー名が同じ場合、結合元のロボット ユーザーにユーザー ID が追加されて、結合先の組織に移動されます。

結合元のロボット ユーザー名	結合先のロボット ユーザー名	移動後の結合元のロボットのユーザー名
sameRobot	sameRobot	sameRobot_47a26d4a-2180-4fdd-8e1e-2379300a1162

グループ

結合元と結合先のロボット グループ名が同じ場合、結合元のロボット ユーザーに文字列が追加されて、結合先の組織に移動されます。

結合元のグループ名	結合先のグループ名	移動後のソース グループのユーザー名
sameGroup	sameGroup	sameGroup_db39a5c6-f73c-4011-b40e-4ea620fe3d01

設定

結合元の設定と結合先の設定が同じ名前の場合、結合先の設定の値が使用されます。

組織のマージに失敗した場合

組織のマージに失敗した場合は、ログを確認します。移行が失敗したのが Identity か Orchestrator かによって、以下の手順を実行します。

Identity の移行が失敗した

Identity の移行が失敗した場合は、エラーを修正して組織のマージ コマンドを再度実行できます。Identity の操作に対してトランザクションが設定されているため、すべての変更がロールバックされます。

Orchestrator の移行に失敗した

Orchestrator の移行に失敗した場合、Orchestrator データベースはロールバックされますが、Identity データベースはロールバックされません。このため、Identity データベースのバックアップを復元し、接続文字列を置換してから新しいデータベースを使用する必要があります。エラーを修正したら、組織のマージ コマンドを再度実行します。

Orchestrator の移行に失敗した場合は、次の手順を実行します。

1. Identity データベースのバックアップを復元します。

   1. データベース ディレクトリを右クリックして、[Import Data-tier Application] を選択します。

      
   2. バックアップ データベース ファイルを選択します。

      
   3. バックアップ データベース名を入力します。

      
   4. プロセスが完了するまで待ちます。

      

2. Identity の接続文字列を置換します。

   `"platform": {
       "sql_connection_str": "<dotnet connection string>",   (added line)
       "enabled": true, 
   },`

3. エラーを修正し、新しいプラットフォームの接続文字列を使用して、マージ コマンドを再び実行します。