手动：在线升级

准备

重要提示：

在第一个服务器节点上执行以下步骤，然后在集群中的所有其他节点（服务器和代理）上执行。

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

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

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

1. 使用 SSH 登录到任何服务器计算机。对于其中只有一个服务器节点的单节点评估配置文件，请登录该节点。
2. 成为根用户:

   sudo su -

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

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

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

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

5. 解压缩as-installer.zip :

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

6. 向安装程序提供权限：

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

7. 在第一个服务器节点上生成最新的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

   • 如果从 Automation Suite 2022.10 升级到 Automation Suite 2023.4 或更高版本，并且新旧版本中都启用了 Orchestrator，则必须在 cluster_config.json 文件中将 orchestrator.block_classic_executions 标志设置为 true。使用该标志即表示您同意阻止传统文件夹执行。不使用该标志会导致升级操作失败。有关配置示例，请参阅特定于 Orchestrator 的配置。
   • 如果您正在使用已连接到外部 Orchestrator 的 AI Center^TM，请确保 cluster_config.json 文件中具有 Orchestrator 证书。如果从低于 2022.10 的版本升级，将 Orchestrator 证书复制到虚拟机。复制证书后，cluster_config.json 中需要以下配置详细信息：

     "aicenter": {
         "enabled": true,
         "orchestrator_url": "https://orchestrator.example.com", //Specify the Orchestrator URL for AI Center
         "identity_server_url": "https://orchestrator.example.com/identity", //Specify the Identiy URL for AI Center
         "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to the Orchestrator certificate
         "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to Identity certificate file
         "metering_api_key": "test" //Specify the metering API key
       }

     注意：如果 AI Center 需要外部 Orchestrator，请在 cluster_config.json 文件中添加 sql_connection_string_template 和 sql_connection_string_template_odbc。

     升级到 AI Center 2023.4 并移至外部存储后，便无法公开在 2022.4 中创建的技能。要解决此问题，请从此处运行脚本。

   • 如果要从先前版本升级 Automation Suite，并且现在还要启用 Process Mining，则必须更新 sql_connection_string_template_sqlalchemy_pyodbc。以下是一个示例。

     "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

   • 如果您从 2023.4 之前的版本升级 Automation Suite ，并且启用了 Apps，则必须为 Apps 创建 SQL 数据库，然后使用以下配置更新 cluster_config.json 文件：

     "apps": {
     "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
     "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
     }

     备注：

     在后续升级步骤中使用更新的 cluster_config.json 文件。

   另请参见手册：高级安装体验。

8. （可选）如果您仍使用安装程序生成的自签名证书，请运行以下命令。 在第一个服务器节点上需要执行此步骤，您将在其中执行 UiPath 产品的升级。

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

执行

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

配置备份

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

1. 确保您在集群上启用了备份。您必须使用与当前部署所用版本相同的安装程序版本创建备份。有关说明，请参阅与您计划升级的 Automation Suite 版本相对应的备份和还原文档。例如，如果您计划从 Automation Suite 2021.10 进行升级，请按照 2021.10 指南中的说明进行操作。
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 --accept-license-agreement

   重要提示：

   如果收到以下错误，请按照将 Ceph 从 16.2.6 降级到 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 产品服务

重要提示：如果您之前使用 2022.10.3 之前的任何 Azure 模板版本部署了单节点安装，并且现在想要升级到较新的 Automation Suite 版本，则必须将 /opt/UiPathAutomationSuite/Installer 中，cluster_config.json 文件内的 zone_resilience 标记设置为 false。

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

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 --accept-license-agreement -o ./output.json

   重要提示：

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

   从 Automation Suite 2021.10 手动升级后，您还必须迁移到 Cilium CNI。有关说明，请参阅从 Canal 迁移到 Cilium CNI。

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

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

  kubectl get applications -n argocd

• 从低于 2023.4.0 的 Automation Suite 版本升级时，请验证 Apps 是否正在运行，然后删除 MongoDB：

  ./configureUiPathAS.sh mongodb uninstall --force

• 如果您在使用 ./configureUiPathAS.sh mongodb uninstall --force 命令删除 MongoDB 时遇到错误，请运行以下命令：

  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
  
  ./configureUiPathAS.sh mongodb uninstall --force
  
  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'

• 如果在执行升级后遇到映像漏洞或存储消耗问题，请从旧的安装程序中删除映像。有关详细信息，请参阅故障排除部分。

启用升级后备份

升级并执行清理和迁移操作后，您必须继续备份。

重要提示：

在继续以下步骤之前，请确保 Automation Suite 已启动并正在运行，并且您的自动化按预期继续进行。

要启用备份，请按照备份和还原集群文档中所述的说明进行操作。

使用部署模板完成升级

执行 Automation Suite 集群升级后，Azure 和 AWS 模板部署需要进行一些更改，以确保新节点通过横向扩展操作正确加入集群。 要自动执行更改，我们建议使用专用脚本。 有关说明，请参阅 Azure 部署模板文档 和 AWS 部署模板文档。

特别注意事项

对使用 Azure 模板部署的集群执行升级时，可能会出现类似于下图所示的错误：

这是由 Azure 负载均衡器的工作方式所造成。要解决此问题，请修改 cluster_config.json 文件中的 fixed_rke_address 字段。在运行升级命令之前，您必须将此字段的值更改为第一个服务器实例的 IP 地址。由于节点运行状况不佳，上传到密钥保管库的 cluster_config.json 应继续具有 ILB 的 IP 地址，并且不会平衡到该节点的流量。