执行单租户迁移

提示：

这是将独立 Orchestrator 迁移到 Automation Suite 的两种方法之一。

For more information, see Migration options.

该工具可以迁移到 Automation Cloud™ 或 Automation Suite，但此页面将介绍迁移到 Automation Suite 的流程。有关迁移到 Automation Cloud 的说明，请参阅Automation Cloud 文档。

您可以使用 UiPath Automation Cloud™ 迁移工具将实体从独立的 Orchestrator 自动迁移到 Automation Suite 中的 Orchestrator 服务。

备注：

您只能在以下情况下使用 Automation Cloud 迁移工具：

• 您的独立 Orchestrator 版本为 2019.10.x， 2020.10.x、 2021.4.x、2021.10.x 或更高版本。
• 您的 Automation Suite 版本为 2021.10.x 或更高版本。

迁移的实体

当您运行 Automation Cloud 迁移工具时，它会在 Automation Suite 中自动创建以下实体，以匹配您的独立 Orchestrator 设置：

实体	已迁移	未迁移
设置	是，但有例外（见右侧）。	某些在读取路径上向租户公开的设置无法在 Automation Suite 中修改，例如主机徽标和颜色。 “设置”表格中的密码无法导出，这是因为 API 会从响应中删除相应的值。因此，不会迁移任何密码。这会影响电子邮件警示（SMTP 密码）和具有基本身份验证的外部订阅源。
包	迁移所有包和所有包版本。 如果包订阅源为外部并配置了基本身份验证，则需要在迁移完成后输入凭据。	如果包订阅源为外部且无法通过互联网访问，则不迁移依赖于这些包的实体。
库	仅租户级别的订阅源。	如果库订阅源为主机级别或为外部，且无法通过互联网访问，则不会迁移依赖这些库的实体。
日历	是	不适用
计算机	是，但如果没有足够的许可证来容纳计算机插槽分配，则系统将在导入计算机时将所有插槽设置为 0。	计算机密钥不会迁移。
文件夹	Yes You can choose to migrate all folders in bulk, as well as individual folders.	个人工作区文件夹不会迁移。
环境	是，适用于传统文件夹。	不适用新式文件夹。
机器人（传统）	是，但如果许可证不足，无法创建机器人，则系统会在导入过程中跳过机器人。	当许可证用尽并且每个许可证有错误记录时跳过。
机器人（新式）	如果 Automation Suite 中存在关联的用户并且具有相同的电子邮件地址，则会迁移新式机器人。	如果 Automation Suite 中不存在该用户，则该特定机器人迁移将失败。 当许可证用尽并且每个许可证有错误记录时跳过。
环境关联	机器人-环境映射会迁移。	不适用
流程	流程会迁移。该工具可能会将其称为“版本”。	不适用
队列	是	不适用
触发器	触发器会迁移，但都设置为禁用状态。
资产	完全支持布尔值、文本和整数等资产类型。 凭据资产也会迁移，但会使用虚拟密码，这是因为此工具无法迁移密码。迁移后，您需要手动更新每个凭据资产的密码。凭据资产将分配给 Automation Suite 中的默认凭据存储。 每机器人值也会迁移，但如果机器人未迁移，则会跳过此值并记录导入警告。	不支持新式文件夹中的每用户资产值。该资产将导入默认值，如果未设置，则跳过该资产。
计算机关联	机器人-计算机映射会迁移。	不适用

未迁移的实体

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

• 文件夹订阅源
• 用户
• 队列项目
• 操作目录
• Webhooks
• 测试实体（测试集、测试用例、测试执行、测试计划、测试数据队列）
• 日志

先决条件

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

1. 确保您在 Automation Suite 中有足够的机器人许可证来匹配要迁移的机器人的数量（ “管理员” > “许可证” > “机器人和服务”）。该工具只会在有许可证的情况下迁移机器人，然后开始跳过机器人。
2. 您必须要有独立 Orchestrator 的管理员凭据，并拥有对要迁移的所有实体的“查看”权限。如果您没有某些实体的查看权限，则不会迁移这些实体。
3. 您必须是 Automation Suite 中的组织管理员。
4. 要运行该工具，您需要一台具有以下功能的计算机：
   1. 可以连接到独立 Orchestrator 和 Automation Suite（可访问互联网）
   2. 拥有 Windows 操作系统
5. 访问此链接，在上述计算机上下载该工具。
6. 在目标 Automation Suite 组织中将该工具注册为外部应用程序。

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

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

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 以供日后使用。

运行工具

该工具一次只能迁移一个租户。您可以为每个租户多次运行该工具。

每次运行时，该工具都会：

1. 连接到独立 Orchestrator，以导出给定租户的实体。
2. 连接到 Automation Suite，以在 Orchestrator 租户中导入和创建已迁移的实体。

For more information about entities that are subject to migration, see Entities Being Migrated.

要运行该工具，请执行以下操作：

1. 提取您为该工具下载的 ZIP 文件，然后运行工具 EXE。

2. 对于激活方法，请选择“连接到内部部署”：

   

3. 填写相关信息，以允许该工具连接到独立的 Orchestrator：

   

   请确保您提供的凭据适用于管理员帐户，并且该帐户对要迁移的所有实体具有查看权限。

4. 选择“开始导出”以连接到独立 Orchestrator 并下载设置信息。导出随即开始，可能需要一段时间才能完成：

   

   完成后，导出摘要将列出已成功导出的所有实体：

   

   您可以选择“打开文件” ，查看为导出摘要创建的本地文件，其中包括一些详细信息。

5. 选择“主页” ，以返回到第一个屏幕。

6. 对于激活方法，这次选择“连接到 Automation Suite”。

7. 填写信息，以允许该工具连接到 Automation Suite 并上传设置信息：

   

   字段	详细信息
   Automation Suite URL	托管 Automation Suite 的 URL，包括协议并以斜杠 (/) 结尾。 您可以在 Automation Suite 中从浏览器地址栏中选取此 URL，但不要包含 URL 中以组织名称开头的部分。例如，如果浏览器中的 URL 为 https://mySite.com/docs/Migration/orchestrator_/?tid=34&fid=82，组织名称为 docs，则您只需在此字段中指定 https://mySite.com/。
   客户端应用程序 ID	与 Automation Suite 中的外部应用程序注册关联的应用程序 ID值。 您可以在“管理” > “外部应用程序”页面上找到此值。
   组织名称	Automation Suite URL 特定于组织的部分。组织管理员可以在“管理员” > “组织设置”下的“组织名称”字段中找到此信息。 您不需要包含完整的 URL，只需包含可编辑的部分，也就是特定于您的组织的部分。例如，如果 URL 为https://mySite.com/``myOrgName ，则将myOrgName添加到字段中。
   租户名称	要在其中添加已迁移信息的 Automation Suite 租户的确切名称。迁移的数据将显示在指定的 Orchestrator 租户中。

8. 选择“开始导入”以连接到 Automation Suite，然后开始将信息迁移到目标 Orchestrator 租户。

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

   

   To connect to Automation Suite using OAuth, a user with the adequate permissions for the scopes added when you registered the external application must log in to Automation Suite. When they do, a new window opens with a success message if the OAuth flow was successful:

   

   完成后，导入摘要将列出已成功导入 Automation Suite 中 Orchestrator 租户的所有实体：

   

   任何未导入的内容都将列为错误，部分导入将列为警告。您可以选择“查看报告” ，以详细了解有哪些实体遇到错误或警告。

9. 准备就绪后，单击“完成”以关闭工具。

   提示：

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

迁移后任务

由于该工具无法迁移所有内容，因此您必须手动执行一些最终任务，才能获得与独立 Orchestrator 中相同的设置。

1. 在 Automation Suite 中，登录作为导入目标的租户的组织，然后打开 Orchestrator。

2. 检查文件夹和实体是否已成功迁移。

   您可以使用导入摘要来检查存在警告或错误的特定项目。

3. 为 Orchestrator 分配机器人和服务许可证。

   在导入期间，将在存在可用许可证的情况下创建计算机并授予许可证。许可证用完后，将继续在没有许可证的情况下创建计算机，因此您必须更新任何此类计算机，以分配足够数量的许可证。

   备注：

   如果您在未激活 Automation Suite 许可证的情况下进行迁移，则在此阶段需要激活许可证以继续安装。

4. 手动上传工具未迁移的任何库订阅源。

5. 如果在导出或导入期间跳过了任何机器人，请手动创建机器人。

6. 创建工具不会迁移的任何 Webhook、任务目录、凭据存储或其他信息。

   The section Entities being migrated includes a list of what the tool does not migrate.

7. 手动将机器人连接到 Automation Suite Orchestrator 服务。

8. 根据需要手动启用触发器。

   该工具迁移触发器时，它们都被禁用，您必须手动启用它们。

9. 检查 Orchestrator 中所有需要密码的位置，并将添加：机器人、设置和凭据资产。

获取帮助

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

• 日志文件（位于 logs 子文件夹中）
• 导出报告文件（在 MigrationAssets 子文件夹中）
• 导入报告文件（在“迁移资产”子文件夹中）

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

• 独立 Orchestrator 的版本
• 您的 Automation Suite 组织和租户名称。