离线升级

准备

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

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

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

1. 识别在 /uipath 装载点附加了其他 UiPath bundle 磁盘的服务器（而非代理）节点。此节点在整个文档中被称为主服务器节点。对于其中只有一个服务器节点的单节点评估配置文件，您必须登录该节点。
   注意：在集群中的所有节点上执行以下步骤。首先是服务器节点，然后是代理节点。
2. 使用 SSH 连接到节点。
3. 成为根用户：

   sudo su -

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

   <h1>Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>

5. 下载 sf-installer.zip 并将其复制到 /opt/UiPathAutomationSuite/{version}/installer。 有关下载说明，请参阅 sf-installer.zip。

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

6. 下载 sf-infra.tar.gz 并将其复制到 /opt/UiPathAutomationSuite/{version}。 有关下载说明，请参阅 sf-infra.tar.gz：

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

7. （仅在 主服务器节点上）。 下载 sf.tar.gz 并将其复制到 /uipath/{version}。 有关下载说明，请参阅 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. 在第一个服务器节点上生成最新的 cluster_config.json ，并将其复制到其余节点。 有关如何配置 cluster_config.json 参数的详细信息，请参阅 使用配置文件。

• 如果您有旧版 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

添加 AI Center 特定配置

1. 使用编辑器（例如 vi）打开cluster_config.json 。

   vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json

2. 替换以下块：

   "aicenter": {
     "enabled": "false"
   },

   注意：如果启用了 AI Center，则默认启用 Document Understanding。
3. 使用以下信息（将 <> 之间的信息替换为您的值）：

   "aicenter": {
     "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
     "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
     "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_access_token": "<placeholder will be replaced later>",
   },

执行

警告：如果在升级期间或之后发生任何错误或问题，只要您之前配置了备份，就可以回滚到以前的版本。有关说明，请参阅“出错时回滚”。

配置备份

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

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

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

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

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

将集群置于维护模式

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

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

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
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

   重要提示：如果出现错误，请按照“将 Ceph 从 16.2.6 降级到 15.2.9”中的说明进行操作。

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

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

1. 连接到任何服务器节点。
2. 通过运行 sudo su - 成为根用户。
3. 运行以下命令：

   replace {version} with the version you are upgrading to in both the commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

4. 使用以下命令运行软件安装程序。

   首先，您需要连接到身份服务器并检索安装令牌。 然后复制此令牌并将其粘贴到“cluster_config.json”文件中的占位符中。

   一旦令牌存在，您就可以运行 AI Center 安装程序。

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

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

启用升级后备份

警告：请确保 AI Center 已启动并正在运行，且您的自动化按预期继续进行，然后再继续执行后续步骤。

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

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

replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups