Automation Suite
2022.10
バナーの背景画像
Automation Suite インストール ガイド
最終更新日 2024年2月12日

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

(Linux 用)

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

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

./UiPath.OrganizationMigrationApp merge -i '<Identity DB connection string>' -o '<Orchestrator DB connection string>' -s '<List of source organizations to merge separated by comma, e.g. orgID1,orgID2>' -d '<List of destination organizations to merge separated by comma, e.g. orgID1,orgID2>' -t '<List of tenant IDs to link Orchestrator, e.g. tenantId1,tenantId2>'./UiPath.OrganizationMigrationApp merge -i '<Identity DB connection string>' -o '<Orchestrator DB connection string>' -s '<List of source organizations to merge separated by comma, e.g. orgID1,orgID2>' -d '<List of destination organizations to merge separated by comma, e.g. orgID1,orgID2>' -t '<List of tenant IDs to link Orchestrator, e.g. tenantId1,tenantId2>'
注:
入力内のソース SQL 接続と宛先 SQL 接続の両方に対して TrustServerCertificate=True を必ず追加してください。
注:
マージする組織のペアが複数ある場合は、ソースとターゲットのシーケンスの orgIdorgIdtenantId が一致することを確認してください。

(Windows 用)

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

./UiPath.OrganizationMigrationApp merge -i "<Identity DB connection string>" -o "<Orchestrator DB connection string>" -s "<List of source organizations to merge separated by comma, e.g. orgID1,orgID2>" -d "<List of destination organizations to merge separated by comma, e.g. orgID1,orgID2>" -t "<List of tenant IDs to link Orchestrator, e.g. tenantId1,tenantId2>"./UiPath.OrganizationMigrationApp merge -i "<Identity DB connection string>" -o "<Orchestrator DB connection string>" -s "<List of source organizations to merge separated by comma, e.g. orgID1,orgID2>" -d "<List of destination organizations to merge separated by comma, e.g. orgID1,orgID2>" -t "<List of tenant IDs to link Orchestrator, e.g. tenantId1,tenantId2>"
注: 入力内のソース SQL 接続と宛先 SQL 接続の両方に対して TrustServerCertificate=True を必ず追加してください。

移行ツールの入力

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

  • 移行元の組織

  • テナント ID

  • 移行先の組織

移行元の組織

結合元の組織のリストを取得するには、スタンドアロン データベースで次のコマンドを実行し、復元したデータベースで GlobalId を関連するパーティション (組織) 名とともに使用します。
SELECT * FROM [identity].[Partitions]SELECT * FROM [identity].[Partitions]

テナント ID

テナント ID のリストを取得するには、SQL サーバー上の AutomationSuite_Platform データベースで次のコマンドを実行します。テナント ID は Id 列で確認できます。
SELECT TOP 10 * FROM [oms].[Tenant] WHERE Name = '*'SELECT TOP 10 * FROM [oms].[Tenant] WHERE Name = '*'

移行先の組織

結合先の組織のリストを取得するには、SQL Sever 上の AutomationSuite_Platform データベースで次のコマンドを実行します。結合先の組織は OrganizationId 列で確認できます。指定するパスワードに含まれる特殊文字は適切にエスケープしてください。
SELECT * FROM [oms].[Tenant]SELECT * FROM [oms].[Tenant]
たとえば、haonantest1as という組織にテナント tenant haonantest1ashaonantest2as という組織内にテナント tenant haonantest2as を合わせて 2 つ作成したとします。次の図に示すように、2 つのテナント ID を記録する必要があります。
docs image

結合に関する期待

ユーザー

条件

結合元のユーザーはメール アドレスを持っているか

結合先のユーザーはメール アドレスを持っているか

結合元のユーザーのメール アドレスは結合先のユーザーと同じか

結合元のユーザー名は結合先のユーザー名と同じか

結果

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] を選択します。
      docs image
    2. バックアップ データベース ファイルを選択します。
      docs image
    3. バックアップ データベース名を入力します。
      docs image
    4. プロセスが完了するまで待ちます。
      docs image
  2. Identity の接続文字列を置換します。

    `"platform": {
        "sql_connection_str": "<dotnet connection string>",   (added line)
        "enabled": true, 
    },``"platform": {
        "sql_connection_str": "<dotnet connection string>",   (added line)
        "enabled": true, 
    },`
  3. エラーを修正し、新しいプラットフォームの接続文字列を使用して、マージ コマンドを再び実行します。

Was this page helpful?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
UiPath ロゴ (白)
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.