手动：离线升级

准备

重要提示：

确保所有节点上的/opt/UiPathAutomationSuite文件夹中都有 10GiB 的可用空间。 如果空间不足，您可以增加此文件夹的容量，也可以删除除cluster_config.json之外的所有以前的安装程序文件。 您始终可以再次下载以前的安装程序。

要验证可用空间，请运行以下命令： df -h /opt/UiPathAutomationSuite 。

要准备升级，请执行以下步骤：

1. 识别在/uipath装载点附加了其他UiPath bundle磁盘的服务器（而非代理）节点。 此节点在整个文档中称为主服务器节点。 对于只有一个服务器节点的单节点评估配置文件，您必须登录到该节点。

   备注：

   在集群中的所有节点上执行以下步骤。 首先是服务器节点，然后是代理节点。

2. 使用 SSH 连接到节点。

3. 成为根用户:

   sudo su -
   

4. 在/opt/UiPathAutomationSuite目录下创建安装文件夹：

   # Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer
   

5. Download sf-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
   

6. Download sf-infra.tar.gz and copy it to /opt/UiPathAutomationSuite/{version}. For download instructions, see sf-infra.tar.gz:

   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
   

7. (Only on the primary server node). Download sf.tar.gz and copy it to /uipath/{version}. For download instructions, see sf.tar.gz:

   cp /path/to/sf.tar.gz /uipath/{version}
   

8. 解压缩sf-installer.zip :

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .
   

9. 为安装程序提供必要的权限：

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
   

10. Generate the latest cluster_config.json on the first server node and copy it to the rest of the nodes. For details on how to configure the cluster_config.json parameters, see Advanced installation experience.

    • 如果您有旧版cluster_config.json ，请通过运行以下命令从集群生成配置文件：

      cd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
      

    • 如果您没有旧的cluster_config.json文件，请生成一个覆盖，以覆盖您在安装先前版本时可能已完成的任何默认值：

      cd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -o ./cluster_config.json
      

执行

重要提示：

If any errors or issues occur during or following the upgrade, you can rollback to the previous version, provided that you previously configured a backup. For instructions, see Rollback on error.

配置备份

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

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.

2. 通过 SSH 连接到其中一个服务器节点。

3. 通过运行以下命令，验证所有所需的卷在集群中是否都有备份：

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

   备注：

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

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

将集群置于维护模式

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

重要提示：

此操作将导致停机，并且您的业务自动化将在整个升级过程中暂停。

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

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode
   

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

   ./configureUiPathAS.sh is-maintenance-enabled
   

   重要提示：

   启用维护模式后，创建 SQL Server 的备份，以便 SQL 数据库中不再记录任何事务。

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

重要提示：

您必须在集群中的所有节点上执行基础架构升级。

您不能同时在多个节点上执行此步骤；您必须等待每个节点上的升级完成，然后才能移动到另一个节点。

1. 登录到要执行基础架构升级的每个节点。

2. 通过运行 sudo su - 成为根用户。

3. 确保在服务器和代理节点上启用rke service 。

   如果该服务已禁用，请通过运行以下命令启用该服务：

   • 对于服务器节点：

     [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service
     

   • 对于代理节点：

     [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
     

4. 要开始升级，请运行以下命令：

   重要提示：

   确保已按照准备步骤中的说明更新生成的cluster_config.json 。

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement
   

   重要提示：

   If you get the following error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

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

此步骤将升级与集群一起运行的结构和服务组件。 您只能在主服务器节点上执行此步骤。

1. 连接到主服务器节点。

2. 通过运行 sudo su - 成为根用户。

3. 运行以下命令：

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   /install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --install-offline-prereqs --accept-license-agreement
   

   重要提示：

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

   After manually upgrading from Automation Suite 2021.10 to 2022.4, you must also migrate to Cilium CNI. For instructions, see Migrating from Canal to Cilium CNI.

执行升级后，您可以执行以下附加步骤：

• 要验证 Automation Suite 是否运行正常，请运行：

  kubectl get applications -n argocd
  

• If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.

启用升级后备份

重要提示：

请确保 Automation Suite 已启动并正在运行，并且您的自动化按预期继续运行，然后再继续执行后续步骤。

在开始升级集群之前，升级脚本会自动创建集群的备份，然后暂时将其禁用。 升级完成后，您可能需要手动启用备份。

要启用备份，请从任何服务器节点运行以下命令：

# replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh resume-scheduled-backups