迁移先决条件

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

.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实用程序。

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
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\`""

备注：

确保仅在有权访问 RDS 数据库的计算机上执行该命令。

管理员组配置要求

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

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

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

Test Manager 迁移脚本

Test Manager 迁移脚本 ( testmanager_migrator.sh ) 可帮助您执行多个自动操作，以迁移各种配置和文件，例如：

• 执行kubectl操作，例如更新密码和配置映射。
• 通过 CLI 执行 ArgoCD 同步。
• 覆盖配置设置并重新启动部署。
• 将存储文件添加到 Ceph 对象存储。
• 从 MSI 实例还原并更新 Kubernetes 密码中的DataEncryptionKey 。
• 在 ArgoCD 中同步 Test Manager。
• 将文件夹或文件从 Windows 文件存储迁移到目标对象存储，同时在 Kubernetes 密码定义的存储桶中创建所需的目录层次结构。

运行 Test Manager 迁移脚本的环境要求

要成功运行 Test Manager 迁移脚本，您需要确保满足以下环境要求：

• 配置kubectl ，使其与 Automation Suite 集群连接。
  重要提示：

  确保将kubeconfig设置为环境变量。

• 使用以下命令安装jq实用程序yum install jq 。
• 安装argocd CLI。有关更多信息，请访问安装 Argo CD 。
• 安装 Rclone。如需了解详情，请访问RClone 文档。
  备注：

  Rclone 所需的最低版本为 1.56.0。

备注：

如果您在 Azure 中管理身份，请确保使用 Azure 计算机运行脚本。

常见 Test Manager 迁移脚本命令

检查可以使用 Test Manager 迁移脚本执行的以下命令：

 ./testmanager_migrator.sh -d -y \
  -k \"enc key value\" \
  -s blobstoragefolder
    -k|--encryption-key
        The value of the encryption key that will override the key generated during installation.
    -s|--storage-folder
        The location of the storage folder on the local disk.
    -is-|--use-incluster-storage
        Use in cluster Ceph object store.
    -d|--dry-run
        Do not update Test Manager with the new values
    -y|--accept-all
        Do not prompt for confirmation of actions