迁移先决条件

在开始迁移之前，请确保您满足以下先决条件：

.NET Runtime 6.0

运行 UiPath.OrganizationMigrationApp 工具需要 .NET Runtime 6.0 或更高版本。 在运行 UiPath.OrganizationMigrationApp 之前，您必须下载并安装它。

Linux

如果 .NET Runtime 6.0 或更高版本不存在， 请先下载并安装 .NET Runtime for Linux ，然后再使用 UiPath.OrganizationMigrationApp。

要在 RHEL 上安装 .NET Runtime 6.0，请运行以下命令：

sudo yum install dotnet-sdk-6.0 -y

Windows

UiPath.OrganizationMigrationApp 工具至少需要 .NET Runtime 6.0。 如果 .NET Runtime 6.0 及更高版本不存在， 请先下载并安装适用于 Windows 的 .NET Runtime 6.0， 然后再使用 UiPath.OrganizationMigrationApp。

Orchestrator 存储桶创建设置

为确保使用正确的 CORS 策略自动创建 Orchestrator 存储桶，您必须运行以下命令。 该命令要求您在计算机上安装jq实用程序。

cd <AS install directory>
rm -f values.json && rm -f appsettings.json
kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
jq '.AppSettings' values.json > appsettings.json
jq '.["Storage.CreateBucket.OnTenantCreation.Enabled"] = "true"' appsettings.json > temp.json && mv -f temp.json appsettings.json
./bin/uipathctl config orchestrator update-config --app-settings appsettings.json

要安装 jq，请使用以下选项之一：

• 选项 1：运行以下命令：

  yum install -y epel-release yum install -y jq

• 选项 2：运行以下命令：

  shell
  curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
  yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm

警告：无法启用确保使用正确的 CORS 策略自动创建存储桶的 Orchestrator 设置会导致从存储桶下载出现问题，您必须通过手动更新 CORS 策略来解决此问题。

要确认该设置已启用，请运行以下命令：

kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq

如果已启用该设置，则该命令应返回以下响应：

{
  "AppSettings": {
    "Storage.CreateBucket.OnTenantCreation.Enabled": "true"
  }
}

UiPath.OrganizationMigrationApp

UiPath.OrganizationMigrationApp 工具可帮助您执行操作，例如将所有租户的身份数据从独立移动到 Automation Suite 以及合并组织。

要下载 UiPath.OrganizationMigrationApp，请参阅下载安装包。

要查看哪个 UiPath.OrganizationMigrationApp 版本与您的环境兼容，请参阅兼容性矩阵。

用于管理 Microsoft SQL Server 的工具

您必须下载并安装 SQL Server Management Studio (SSMS) 或类似工具才能管理 Microsoft SQL Server。 此工具可帮助您将 Orchestrator 数据库还原到 Automation Suite SQL Server 实例或其他 SQL Server 实例。

1. 下载并安装 SQL Server Management Studio。

2. 使用独立 SQL 连接字符串登录独立 SQL Server。

3. 打开源数据库和目标数据库的端口 1433 。

连接字符串密码的特殊字符转义规则

在大多数情况下，连接密码都包含在单引号 (') 中。但是，当密码包含特殊字符（例如 ` 或 $）时，则需要采用不同的方法。

在这些情况下，密码的格式必须为 \`"<password>\`"，并将 <password> 替换为实际密码。此外，您还必须遵守下表中详述的转义规则：

ADDU 中的原始格式	PowerShell 字符串中的转义格式
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

示例

假设原始密码为 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I。遵循特殊字符转义规则，它将变为：Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`"。

在目标连接字符串中配置了密码的完整命令如下所示：

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=[e-mail];Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""

管理员组配置要求

在开始迁移之前，您必须在每个租户中添加管理员组。

如果您正在执行组织合并，且未在所有租户中添加管理员组，则您可以在合并完成后将自己锁定在 Orchestrator 实例之外。

在每个租户中添加管理员组可确保在整个迁移和合并过程中保留管理访问权限。