执行升级

重要提示：

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

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

系统会在 NFS 服务器上备份集群数据。请务必先配置 NFS 服务器，然后再继续。

禁用维护模式后，必须配置备份，以确保完成所有事务。

将集群置于维护模式

Putting the cluster in maintenance mode shuts down the ingress controller and all the UiPath® services, blocking all the incoming traffic to the Automation Suite cluster.

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

   ./configureUiPathAS.sh enable-maintenance-mode

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

   ./configureUiPathAS.sh is-maintenance-enabled

配置备份

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

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

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

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

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

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

重要提示：

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

cd /opt/UiPathAutomationSuite/latest/installer

./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

备注：

• 在主服务器节点上运行上一个命令会将安装程序和 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 变量显式更改了此位置。

Updating the shared components and UiPath® product services

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

   ./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f -s --accept-license-agreement

   重要提示：

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

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

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

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health test --versions versions.json

   备注：

   要下载 versions.json，请参阅下载安装包。

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