执行升级

重要提示：

要执行 Automation Suite 升级，您必须将集群置于维护模式。维护模式会导致整个升级过程停机，在此期间您的业务自动化将暂停。

强烈建议在升级 AI Center 之前创建集群和 SQL 数据库的备份。这是为了确保您可以在升级操作期间出现问题时还原集群。

运行先决条件检查

在将集群置于维护模式之前，您必须验证是否满足所有升级要求。

1. 使用以下命令运行基础架构先决条件检查：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json

2. 使用以下命令运行共享组件和服务先决条件检查：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json

配置备份

要配置备份，请执行以下步骤：

1. 确保您在集群上启用了备份。您必须使用与当前部署所用版本相同的安装程序版本创建备份。有关说明，请参阅与您计划升级的 Automation Suite 版本对应的备份和还原文档。例如，如果您计划从 Automation Suite 2023.4 升级，请按照 2023.4 指南中的说明进行操作。
2. 通过 SSH 连接到其中一个服务器节点。
3. 验证集群中是否所有所需的卷都有备份：

   • 如果您从 2022.4 或更早版本升级，请运行以下命令：

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   • 如果从 2022.10 或更高版本升级，请运行以下命令：

     ./configureUiPathAS.sh snapshot list

   • 如果从 2024.10 或更高版本升级，请运行以下命令：

     ./bin/uipathctl snapshot list

   注意：备份可能需要一些时间，因此请等待大约 15 至 20 分钟，然后再次验证卷备份。

创建备份后，请继续执行以下步骤。

备注：

从 23.10.0 或更高版本升级时，请确保使用目标版本目录中的uipathctl命令。

禁用备份

在将集群置于维护模式之前，必须禁用备份，以避免在备份时处于次选状态的集群。 有关详细信息，请参阅。

将集群置于维护模式

将集群置于维护模式将关闭入口控制器和所有 UiPath™ 服务，并阻止所有流入 Automation Suite 集群的流量。

1. 要将集群置于维护模式，请运行：

   ./bin/uipathctl cluster maintenance enable

2. 要验证集群是否处于维护模式，请运行：

   ./bin/uipathctl cluster maintenance is-enabled

将 Longhorn 工作负载、MongoDB 数据和 Ceph 迁移到基于 Helm 的部署

要将 Longhorn 工作负载迁移到本地 PV，将 MongoDB 数据迁移到 SQL，并将 Ceph 安装从 ArgoCD 迁移到基于 Helm 的部署，请运行以下命令：

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

更新 Kubernetes 和其他基础架构组件

要升级 Kubernetes 和其他基础架构组件，请在主服务器节点上运行以下命令：

重要提示：

确保您按照更新集群配置中的说明更新了生成的 cluster_config.json 文件。

cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json

备注：

• 在主服务器节点上运行上一个命令会将安装程序和 cluster_config.json 复制到 /opt/UiPathAutomationSuite/<version>/installer 默认位置，并升级所有计算机上的基础架构。
• /opt/UiPathAutomationSuite/<version> 默认位置的所有节点必须至少有 5 GiB 可用。

• 要更改默认位置，请使用所需位置更新以下环境变量。确保该位置在所有节点上可用，并且具有运行升级所需的权限。

  export INSTALLER_DIRECTORY=/path/to/copy/installer

• 执行上一个命令并运行升级后，系统会将安装程序文件复制到 /path/to/copy/installer/<version>/installer 位置。将 version 替换为您执行的安装程序的版本。

故障排除

• 除非您明确为安装程序使用了自定义位置，否则主服务器上的升级日志可在 /opt/UiPathAutomationSuite/latest/installer/upgrade-logs 默认位置中找到。
• 在所有其他节点上，日志位于 /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs 默认位置，除非您通过 INSTALLER_DIRECTORY 变量显式更改了此位置。

安装共享组件和 UiPath™ 服务

1. 要安装共享组件和 UiPath™ 产品服务，请在主服务器节点上运行以下命令：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json

   重要提示：

   完成升级后，系统将自动禁用维护模式。

2. 要验证 Automation Suite 是否运行正常，请运行以下命令之一：

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl health check

   备注：

   如果找不到helm-charts.json ，也可以使用versions.json 。 要下载versions.json ，请参阅下载安装包。

完成升级后，执行适合您的清理和迁移活动。