使用 Automation Cloud 迁移工具

Automation Cloud 迁移工具是一个桌面应用程序，旨在简化从一个部署选项迁移到另一个部署选项的过程。 该工具可自动执行各种迁移步骤，从而更轻松地将独立版或 Automation Suite Orchestrator 转换到 Automation Cloud、Automation Cloud Public Sctor 或 Automation Suite。

此页面上的说明适用于将 On-Premises Orchestrator（独立或通过 Automation Suite）迁移到Automation Cloud ^TM 。

在计划从 On-Premises Orchestrator 迁移到Automation Cloud ^TM时，建议您执行以下步骤：

1. 升级到受支持的 On-Premises Orchestrator 版本。

2. 从传统文件夹迁移到新式文件夹，因为传统文件夹在Automation Cloud ^TM中有限制。

3. 运行此迁移工具，以从 On-Premises Orchestrator 迁移到Automation Cloud ^TM 。

备注：

• 虽然其他序列在技术上也可行，但这是最常见的方法。

• Automation Cloud 迁移工具独立运行，不符合我们的标准产品生命周期。

要求

要使用迁移工具，您必须满足以下条件：

• 必须支持您的独立 Orchestrator 版本。有关特定版本的详细信息，请参阅我们的产品生命周期文档。

• 您需要在 Automation Cloud 中拥有 Pro 版、Pro Trial 版或 Enterprise 版许可证。虽然您可以在 Pro Trial 版期间使用该工具进行评估，但可能存在一些限制，例如租户和机器人许可证限制。如需了解详情，请参阅许可证文档。

先决条件

在打开 Automation Cloud 迁移工具之前，请做好以下准备：

1. 检查Automation Cloud ^TM中的 Enterprise 或 Enterprise Trial 许可计划是否处于活动状态（“管理员”>“许可证”）。

2. 请确保您拥有足够的机器人许可证来匹配要迁移的机器人的数量（“管理员”>“许可证”> “机器人和服务” ）。 只要有许可证，该工具就会迁移机器人，然后开始跳过机器人。

3. 确保您具有 On-Premises Orchestrator 的管理员凭据

4. 确保您对所有要迁移的实体具有“查看”权限。 如果您没有某些实体的“查看”权限，则系统不会迁移这些实体。

5. 您必须是 Automation Cloud 中的组织管理员，才能将该工具注册为外部应用程序。

6. 确保运行 Automation Cloud 迁移工具的计算机满足以下要求：

   1. 可以连接到 On-Premises Orchestrator；

   2. 可以访问Automation Cloud ^TM （能够访问互联网并且有受支持的浏览器）；

   3. 运行 Windows 操作系统；

   4. 已安装 .NET Core Desktop Runtime x64。

7. 在计算机上下载符合上一步要求的迁移工具。

迁移工具迁移的实体

使用此迁移工具时，系统会在Automation Cloud ^TM中自动创建以下实体，以反映您的 Orchestrator 设置：

实体	已迁移	未迁移
设置	是，但有例外	一些本地部署设置，例如密码和向租户公开的某些设置
包	所有包和包版本	依赖需要身份验证的外部包订阅源的实体 备注： 完成迁移后，需要针对配置了基本身份验证的外部包订阅源进行身份验证
库	仅限租户级别的订阅源	依赖具有主机级配置的库或无法访问的外部库的实体
日历	是	不适用
计算机	是 备注： 由于缺少许可证，计算机插槽分配可能会受到限制	计算机键值
文件夹	是	个人工作区文件夹
环境	是，适用于传统文件夹。	不适用 （适用于新式文件夹）
机器人（传统）	是 备注： 由于缺少许可证，在机器人创建方面可能会受到限制	许可证用尽时跳过，为每个跳过的机器人记录一个错误
机器人（新式）	是 备注： 如果满足某些条件，则机器人会与具有电子邮件地址的本地部署用户相关联，并且该电子邮件地址已经受邀加入Automation Cloud TM ，并已与用户相关联。	许可证用尽时跳过，为每个跳过的机器人记录一个错误 如果Automation Cloud TM中的用户不存在，则失败
环境关联	机器人-环境映射	不适用
流程	是 备注： 迁移工具可能会将流程称为“版本”	不适用
队列	是	不适用
触发器	是，但它们被设置为“已禁用”	不适用
资产	完全支持某些资产类型，但需要注意凭据资产	新式文件夹中的每用户资产值
文件夹订阅源	是	不适用

迁移工具未迁移的实体

迁移工具不会迁移以下实体：

• 用户和机器人帐户

• 角色分配

• 队列项目

• 操作目录

• Webhooks

• 测试实体（测试集、测试用例、测试执行、测试计划、测试数据队列）

• 存储桶

• 日志

将迁移工具注册为外部应用程序

此迁移工具必须连接到Automation Cloud ^TM中的 Orchestrator 服务 API 才能创建迁移的实体。 它使用 OAuth 流程执行迁移，因此您必须将其注册为外部应用程序。

要将 Automation Cloud 迁移工具注册为外部应用程序，请执行以下步骤：

1. 按照 “添加外部应用程序”中的说明，将该工具添加为新的外部应用程序。 确保使用以下配置：

   • 类型：非机密

   • 资源：Orchestrator API

   • 用户作用域：OR.Folders、OR.Settings、OR.Robots、OR.Machines、OR.Execution、OR.Assets、OR.Users、OR.Jobs 和 OR.Queues。
   • 重定向 URL：http://127.0.0.1:8888/auth/

2. 保存应用程序 ID 以供日后使用。

运行迁移工具

该迁移工具一次只能迁移一个租户。您可以为每个租户运行工具。每次运行时，该工具都会执行以下操作：

• 连接到 On-Premises Orchestrator，以导出给定租户的实体。

• 连接到Automation Cloud ^TM ，以在 Orchestrator 中导入和创建已迁移的实体。

若需详细了解要进行迁移的实体，请参阅迁移工具迁移的实体。

1. 提取您为该工具下载的.zip文件，然后运行.exe工具。
2. 要选择导出环境，请执行以下步骤之一：

   • 如果您从独立版 Orchestrator 迁移，请选择“本地部署 MSI”。

   • 如果您从 Automation Suite Orchestrator 迁移，请选择“Automation Suite”，连接到外部应用程序并填写导出输入表单。

     
3. 填写相关信息，以允许该工具连接到 On-Premises Orchestrator。
   

   

   注意：请确保您提供的凭据适用于管理员帐户，并且该帐户对要迁移的所有实体具有查看权限。
4. 选择“开始导出”以连接到源环境并下载设置信息。 导出开始，可能需要一段时间才能完成。
   
   完成后，导出摘要将列出已成功导出的所有实体。您可以选择“打开文件”，查看为导出摘要创建的本地文件，其中包括一些详细信息。

   
5. 选择“主页”以返回到迁移工具的第一个屏幕。
6. 对于激活方法，这次选择 “连接到Automation Cloud ^TM ” 。
7. 填写信息，以允许该工具连接到Automation Cloud ^TM并上传设置信息。
   

   字段	详细信息
   客户端应用程序 ID	与 Automation Cloud TM 中的外部应用程序注册关联的 应用程序 ID 值。 您可以在“管理” > “外部应用程序”页面上找到此值。
   组织名称	Automation Cloud TM URL 特定于组织的部分。 组织管理员可以在“ 管理 ” > “组织设置” 中的“ URL ” 字段中找到此信息。 注意：您不需要包含完整的 URL，只需包含可编辑的部分，也就是特定于您的组织的部分。例如，如果 URL 为 https://cloud.uipath.com/myOrgName，则将 myOrgName 添加到字段中。
   租户名称	要在其中添加已迁移信息的Automation Cloud TM租户的确切名称。 迁移的数据将显示在与该租户关联的 Orchestrator 服务中。

8. 选择“开始导入”以连接到Automation Cloud ^TM ，然后开始将信息迁移到目标 Orchestrator 服务。

   导出开始，可能需要一段时间才能完成。

   要使用 OAuth 连接到Automation Cloud ^TM ，对于在您注册外部应用程序时添加的作用域具有足够权限的用户必须登录到Automation Cloud ^TM 。 完成后，如果 OAuth 流程成功，系统会打开一个包含成功消息的新窗口。

   

   完成后，导入摘要将列出已成功导入Automation Cloud ^TM中 Orchestrator 服务的所有实体。

   

   任何未导入的内容都将列为错误，部分导入将列为警告。 您可以选择“查看报告” ，详细了解有哪些实体遇到错误或警告。
9. 准备就绪后，单击“完成”以关闭工具。

提示：如有需要，您可以再次运行该工具，以迁移其他租户的数据。

迁移后任务

由于 Automation Cloud 迁移工具无法迁移所有数据，您必须手动执行一些最终任务。

1. 在Automation Cloud ^TM中，选择作为导入目标的租户，然后打开 Orchestrator。 检查文件夹和实体是否已成功迁移。 您可以使用导入摘要来检查存在警告或错误的特定项目。
2. 为 Orchestrator 分配机器人和服务许可证。在存在可用许可证的情况下，创建计算机并分配许可证，但在许可证用尽后，将继续在没有许可证的情况下创建计算机，因此您必须进行更新，以分配足够数量的许可证。
3. 手动上传工具未迁移的任何库订阅源。
4. 如果在导出或导入期间跳过了任何机器人，请手动创建机器人。
5. 创建工具不会迁移的任何 Webhook、任务目录、凭据存储或其他信息。“正在迁移的实体”部分还会列出该工具不会迁移的内容。
6. 手动将机器人连接到 Cloud Orchestrator 服务。
7. 根据需要手动启用触发器。
8. 检查 Orchestrator 中所有需要密码的位置，并将添加：机器人、设置和凭据资产。

获取帮助

如果您在导出、导入或导入后遇到问题且需要帮助，请打开支持工单并添加以下文件：

• 日志文件（位于 logs 子文件夹中）

• 导出报告文件（在 MigrationAssets 子文件夹中）

• 导入报告文件（在“迁移资产”子文件夹中）

除了之前的文件外，了解以下信息将有所帮助：

• On-Premises Orchestrator 的版本；

• 您的Automation Cloud ^TM组织和租户名称。