执行升级

重要提示：

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

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

Running the prerequisite checks

You must verify that all the upgrade requirements are met before you put the cluster in maintenance mode.

1. Run the infrastructure prerequisite checks, using the following command:

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

2. Run the shared component and services prerequisite checks, using the following command:

   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

   • If you upgrade from 2024.10 or newer, run the following command:

     ./bin/uipathctl snapshot list

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

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

备注：

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

禁用备份

Before you place the cluster in the maintenance mode, you must disable the backup to avoid backing up the cluster in a suboptimal state. For details, see .

将集群置于维护模式

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

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

   ./bin/uipathctl cluster maintenance enable

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

   ./bin/uipathctl cluster maintenance is-enabled

Migrating Longhorn workloads, MongoDB data, and Ceph to Helm-based deployment

To migrate Longhorn workloads to local PV, MongoDB data to SQL ,and Ceph installation from ArgoCD to Helm-based deployment, run the following command:

./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 变量显式更改了此位置。

Installing the shared components and UiPath® services

1. To install the shared components and the UiPath® product services, run the following command on the primary server node:

   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

   备注：

   If you cannot find helm-charts.json, you can alternatively use versions.json. To download versions.json, see Downloading the installation packages.

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