将数据迁移到新集群

在升级过程中，将数据迁移到新的 Automation Suite 集群。

仅限离线

1. 将源集群上运行的 Docker 注册表与您计划升级到的版本对应的捆绑包结合使用。确保在您在/uipath装载点上附加了 UiPath™ 捆绑包磁盘的源集群的服务器计算机上下载as.tar.gz 。首选位置为/uipath/<new_version>/as.tar.gz 。

2. 创建一个临时位置以解压缩捆绑包。

   mkdir -p /uipath/tmp
   

3. 将源集群 Docker 注册表与最新的离线捆绑包结合使用。

   ./bin/uipathctl registry upload --offline-bundle /uipath/<new_version>/as.tar.gz --offline-tmp-folder /uipath/tmp
   

备注：

您可以在将集群置于维护模式之前运行数据迁移脚本，以减少停机期间的迁移时间。

克隆源集群数据库

重要提示：

• 您可以允许安装程序在共享组件和服务安装期间使用默认名称创建新数据库。有关详细信息，请参阅配置 Microsoft SQL Server 。
• 如果数据库名称不同，则必须删除安装程序创建的数据库，将数据库从源 SQL Server 复制到新 SQL Server，并保留数据库名称。
• 如果您选择更改新 SQL Server 中的数据库名称，则必须为安装的每个产品仔细编辑 cluster_config.json 文件。

1. 确保在源集群上获取新的安装程序，以将数据迁移到新的目标集群。

   请按照下载安装包并在计划触发迁移的源集群的一个服务器节点上的计算机上获取它们中的步骤操作。

2. 将源集群置于维护模式：

   ./bin/uipathctl cluster maintenance enable
   

   重要提示：

   停机时间从现在开始计时。

3. 使用您的首选方法将数据库复制到目标集群。例如，您可以使用复制数据库向导。

克隆源集群数据

1. 通过运行以下命令，获取目标集群的 target_kubeconfig 文件以执行数据迁移：

   ./bin/uipathctl config kubeconfig get --migration
   

   备注：

   需要 target_kubeconfig 文件才能获取目标集群内对象存储的信息并执行目标版本所需的数据复制。

2. 将生成的文件复制到源集群。在数据迁移期间，您需要使用此文件。您必须在以下步骤中将<target_kubeconfig>替换为此文件路径。

3. 通过在源集群上运行数据迁移脚本，将数据从源集群复制到目标集群。

   cd /opt/UiPathAutomationSuite/<new_version>/installer
   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig <target_kubeconfig> --versions versions/helm-charts.json
   

   备注：

   • 先前的迁移命令具有幂等性。如果命令由于网络连接问题而在两者之间失败，您可以重新运行它，并且系统将从中断的位置继续执行迁移过程。
   • （可选）您可以通过再次运行迁移命令来执行数据迁移的差异同步。
   重要提示：

   如果集群使用的是集群内对象存储 (Ceph)，并且您已选择并行升级（单节点启动），则迁移命令可能会在CEPH_SPACE_VALIDATION先决条件检查中失败。发生这种情况是因为源集群具有三个数据副本，而目标集群是具有单节点的非 HA 集群。在这种情况下，您可以跳过先决条件检查：

   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig
           <target_kubeconfig> --versions versions/helm-chart.json
     --skip-pre-reqs
   

4. 如果您在源集群中使用外部对象存储，请克隆对象存储桶。