执行升级

重要提示：

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

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

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

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

将集群置于维护模式

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

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

更新共享组件和 UiPath 产品服务

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

   ./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，请参阅下载安装包。

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