步骤 1：将身份组织数据从独立移动到 Automation Suite

独立版本和 Automation Suite 版本必须相同，否则迁移将由于数据库架构冲突问题而失败。 如果遇到兼容性故障，请确保将独立安装和 Automation Suite 安装升级到最新版本。

适用于 Linux

备注：

在运行 UiPath.OrganizationMigrationApp 之前，请确保下载并安装 .NET Runtime 6.0。有关详细信息，请参阅 迁移先决条件。

要下载 UiPath.OrganizationMigrationApp，请参阅 迁移先决条件。

运行工具

备注：

请务必遵循所选 Shell 工具的一般转义说明。 例如，在 Bash 中，您必须在特殊字符前添加\ 。

UiPath.OrganizationMigrationApp 工具支持以下参数：

参数名称	短名称	描述
独立产品的身份数据库连接	i	独立产品的 Identity 数据库连接。 如果 Identity 和 Orchestrator 共享同一个数据库，则使用该数据库的连接字符串。
Automation Suite 的身份数据库连接	j	Automation Suite 的身份数据库连接。
Orchestrator database connection of the standalone product	o	The Orchestrator database connection of the standalone product. If Identity and Orchestrator share the same database, then use the connection string of that database.
独立产品的组织 ID 列表	s	要合并的独立产品的组织 ID 列表。 必须使用以下格式： orgId1,orgId2,...,orgId5 。 独立产品和 Automation Suite 的组织 ID 列表大小必须相同。 要获取独立产品的组织 ID 列表，请对独立数据库运行以下命令，并在还原的数据库上使用GlobalId和相关分区/组织名称： SELECT * FROM [identity].[Partitions]
Automation Suite 的组织 ID 列表	d	The list of organization IDs for Automation Suite. You must use the following format: orgId1,orgId2,...,orgId5. 独立产品和 Automation Suite 的组织 ID 列表大小必须相同。 要获取 Automation Suite 的组织 ID 列表，请对 Automation Suite SQL Sever 上的AutomationSuite_Platform数据库运行以下命令： SELECT * FROM [identity].[Partitions]
回滚	r	用于回滚更改的参数。
Automation Suite 的 URL	p	The URL of Automation Suite. For example, 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

以下是您可能需要执行的一些常见操作：

• 要将所有租户的身份数据从独立移动到 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>'

  备注：

  确保为输入中的所有 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>'

• 根据错误消息修复问题，并再次尝试将所有租户的身份数据从独立移动到 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"}

。

备注：

在运行 UiPath.OrganizationMigrationApp 之前，请确保下载并安装 .NET Runtime 6.0。有关详细信息，请参阅 迁移先决条件。

要下载 UiPath.OrganizationMigrationApp，请参阅 迁移先决条件。

运行工具

备注：

要成功运行 UiPath.OrganizationMigrationApp 工具，如果 SQL 密码包含特殊字符，则必须对其进行转义。例如，将 $ 的每个实例替换为 \`$。有关如何对连接字符串密码中的特殊字符进行转义的更多准则，请参阅连接字符串密码的特殊字符转义规则。

以下是您可能需要执行的一些常见操作：

• 要将所有租户的身份数据从独立移动到 Automation Suite ，请提取文件并运行以下命令。

  备注：

  确保为源和目标 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 -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

• 根据错误消息修复问题，并尝试再次将所有租户的身份数据从独立版移动到 Automation Suite 。

• After running the previous command, a new tenant named tenant_xxxxxxxx is created, where xxxxxxxx are random characters. This is the tenant to which you will migrate the standalone products.