升级 AI Center

要将 AI Center 从一个次要版本升级到另一个次要版本（例如，从 2021.10.1 升级到 2021.10.2）， 使用此页面中的程序。

注意： 确保升级时没有新的部署。

重要提示：

如果从 AI Center 2021.10.3 或 2021.10.4 升级到较新版本，则需要从 Ceph 16.2.6 降级到 15.2.9，以防止数据损坏。

有关更多信息，请查看“将 Ceph 从 16.2.6 降级到 15.2.9”页面。

部署模式	升级说明
在线单节点评估	在线单节点评估模式
离线单节点评估	离线单节点评估模式
在线多节点 HA 就绪生产	在线多节点 HA 就绪生产模式
离线多节点 HA 就绪生产	离线多节点 HA 就绪生产模式

在线单节点评估模式

准备

1. 确保节点上有足够的磁盘空间。
2. 在服务器上下载并解压新的安装程序 (installer.zip)。
3. 使原始 cluster_config.json 文件在服务器上可用。
4. 生成新的 cluster_config.json 文件，如下所示：

• 如果您有旧的 cluster_config.json，请使用以下命令从集群生成配置文件：

cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

• 如果您没有旧的 cluster_config.json 文件，请运行以下命令：

cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

执行

维护和备份

1. 确保您在集群上启用了备份。
2. 通过 SSH 连接到服务器节点。
3. 通过运行以下命令，验证集群中所有所需的卷是否都有备份：

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

   注意：备份可能需要一些时间，因此请等待大约 15 至 20 分钟，然后再次验证卷备份。
4. 将集群置于维护模式，如下所示：
5. 执行以下命令：

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. 通过运行以下命令验证集群是否处于维护模式：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. 进行 SQL 数据库备份。

升级服务器上的基础架构和服务

1. 通过 SSH 连接到服务器。
2. 通过运行 sudo su - 成为根用户。
3. 删除补丁 json 文件中的 redis 部分。
   由于升级过程中存在已知问题，我们需要手动编辑/opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json文件。 此问题已在 2022.4 版本中修复。
   为此，请使用文本编辑器打开文件，并删除第 22 到 25 行以及第 21 行中的结尾, ：

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   更改后，文件应如下所示：

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. 通过运行以下命令升级基础架构和服务器：

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

5. 通过运行以下命令升级结构：

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

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

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

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

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   注意：此命令将禁用您在升级前启用的维护模式，因为在升级期间所有服务都必须启动。该命令还会创建集群状态的备份，并暂停所有其他计划的备份。
7. 升级和验证成功后，通过运行以下命令在节点上恢复备份计划：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

回滚错误

准备

1. 创建一个单独的文件夹来存储较旧的捆绑包，并在该文件夹中执行以下操作。
2. 在节点上下载并解压旧版本 (installer.zip) 的安装程序。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
3. 创建一个 restore.json 文件并将其复制到所有节点。
4. 验证主服务器上的以下位置是否存在 etcd 备份数据：/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots。
   • etcdBackupPath - 这与启用备份的 node-name 时在 backup.json 中指定的相同；
   • node-name - 主服务器虚拟机的主机名。

集群清理

1. 复制并运行专用脚本，以卸载该节点上的所有内容。对所有节点执行此操作。有关详细信息，请参阅故障排除页面中的如何安装集群一节。
2. 将所有 UiPath 数据库还原到升级前创建的备份。

在服务器节点上还原基础架构

1. 通过 SSH 连接到服务器。
2. 通过运行以下命令还原基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

还原卷数据

1. 通过 SSH 连接到服务器。
2. 转到新的安装程序文件夹。
   注意：先前的基础架构还原命令使用旧的安装程序执行，以下命令使用新的安装程序捆绑包执行。
3. 通过运行以下命令在集群上禁用维护模式：

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. 通过运行以下命令验证是否已禁用维护模式：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. 将基础架构还原阶段使用的 restore.json 文件复制到新的安装程序捆绑包文件夹。
6. 通过从较新的安装程序捆绑包中运行以下命令来还原卷：

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. 还原完成后，请验证是否一切都已还原且工作正常。
8. 在升级过程中，主节点上的计划备份被禁用。要再次启用它们，请运行以下命令：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

离线单节点评估模式

准备

1. 确保节点上有足够的磁盘空间。
2. 在所选服务器上下载完整的离线捆绑包 (sf.tar.gz)。
3. 在主服务器上下载并解压新的安装程序 (installer.zip)。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
4. 使原始 cluster_config.json 文件在服务器上可用。
5. 生成新的 cluster_config.json 文件，如下所示：
   • 如果您有旧的 cluster_config.json，请使用以下命令从集群生成配置文件。

cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

• 如果您没有旧的配置文件，请运行以下命令：

cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

执行

维护和备份

1. 确保您在集群上启用了备份。
2. 通过 SSH 连接到服务器节点。
3. 通过运行以下命令，验证集群中所有卷是否都有备份：

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

   注意：备份可能需要一些时间，因此请等待大约 15 至 20 分钟，然后再次验证卷备份。
4. 将集群置于维护模式，如下所示：
5. 执行以下命令：

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. 通过运行以下命令验证集群是否处于维护模式：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. 创建 SQL 数据库备份。

升级服务器上的基础架构和服务

1. 通过 SSH 连接到服务器。
2. 通过运行 sudo su - 成为根用户。
3. 删除补丁 json 文件中的 redis 部分。
   由于升级过程中存在已知问题，我们需要手动编辑/opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json文件。 此问题已在 2022.4 版本中修复。
   为此，请使用文本编辑器打开文件，并删除第 22 到 25 行以及第 21 行中的结尾, ：

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   更改后，文件应如下所示：

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. 通过运行以下命令升级基础架构：

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -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

5. 通过运行以下命令升级结构：

   /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

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

   首先，您需要连接到身份服务器并检索安装令牌。 然后复制此令牌并将其粘贴到“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

   注意：此命令将禁用您在升级前启用的维护模式，因为在升级期间所有服务都必须启动。请注意，此命令还会创建集群状态的备份，并暂停所有其他计划的备份。

7. 升级和验证成功后，通过运行以下命令在节点上恢复备份计划：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

回滚错误

准备

1. 创建一个单独的文件夹来存储旧的捆绑包，并在该文件夹中执行以下操作。
2. 在所有节点上下载与旧版本相对应的仅基础架构离线捆绑包 (sf-infra-bundle.tar.gz)。
3. 在所有节点上下载并解压旧版本 (installer.zip) 的安装程序。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
4. 创建一个 restore.json 文件并将其复制到节点。
5. 验证主服务器上的以下位置是否存在 etcd 备份数据：/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots。
   • etcdBackupPath - 这与启用备份的 node-name 时在 backup.json 中指定的相同；
   • node-name - 主服务器虚拟机的主机名。

集群清理

1. 复制并运行专用脚本，以卸载该节点上的所有内容。有关详细信息，请参阅故障排除页面中的如何安装集群一节。
2. 将所有 UiPath 数据库还原到升级前创建的较旧备份。

在服务器节点上还原基础架构

1. 连接到服务器节点。
2. 通过运行以下命令还原基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --offline-bundle "/path/to/older-version/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

还原卷数据

1. 通过 SSH 连接到服务器。
2. 转到新的安装程序文件夹。
   注意：先前的基础架构还原命令使用旧的安装程序执行，以下命令使用新的安装程序捆绑包执行。
3. 通过运行以下命令在集群上禁用维护模式：

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. 通过执行以下命令验证维护模式是否已禁用：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. 将基础架构还原阶段使用的 restore.json 文件复制到新的安装程序捆绑包文件夹。
6. 通过执行以下命令，从新的安装程序捆绑包中还原卷：

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type offline

7. 还原完成后，验证是否一切都已还原并正常工作。
8. 在升级过程中，此节点上的计划备份被禁用。要再次启用它们，请运行以下命令：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

在线多节点 HA 就绪生产模式

准备

1. 标识满足在线安装磁盘要求的任何服务器（非代理）。在本文档中称为主服务器。如果您使用的是自签名证书，请运行以下命令：

   <h3>Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./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</h3>

2. 在所有节点上下载并解压新的安装程序 (installer.zip)。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
3. 使原始 cluster_config.json 文件在主服务器上可用。
4. 生成新的 cluster_config.json 文件，如下所示：
   • 如果您有旧的 cluster_config.json 文件，请使用以下命令从集群生成配置文件：

cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

• 如果您没有旧的配置文件，请运行以下命令：

cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

5. 将此 cluster_config.json 复制到所有节点上的安装程序文件夹。

执行

维护和备份

1. 确保您在集群上启用了备份。
2. 通过 SSH 连接到其中一个服务器节点。
3. 通过运行 /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup 验证集群中所有所需的卷是否都有备份。
   注意：备份可能需要一些时间，因此请等待大约 15 至 20 分钟，然后再次验证卷备份。
4. 将集群置于维护模式，如下所示：
5. 执行以下命令：

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. 通过运行以下命令验证集群是否处于维护模式：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. 创建 SQL 数据库备份。

升级服务器上的基础架构

1. 通过 SSH 连接到每台服务器。
2. 通过运行 sudo su - 成为根用户。
3. 在所有服务器上执行以下命令：

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

作为此命令的一部分，我们还将备份集群状态，并暂停所有后续计划的备份。

请注意：此命令还会创建集群状态的备份，并暂停所有其他计划的备份。

升级代理的基础架构

1. 通过 SSH 连接到每台服务器。
2. 通过运行 sudo su - 成为根用户。
3. 执行以下命令：

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

在主服务器上执行其余的升级

1. 通过 SSH 连接到主服务器。
2. 通过运行 sudo su - 成为根用户。
3. 删除补丁 json 文件中的 redis 部分。
   由于升级过程中存在已知问题，我们需要手动编辑/opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json文件。 此问题已在 2022.4 版本中修复。
   为此，请使用文本编辑器打开文件，并删除第 22 到 25 行以及第 21 行中的结尾, ：

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   更改后，文件应如下所示：

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. 通过运行以下命令升级结构：

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

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

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

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

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   注意：此命令将禁用您在升级前启用的维护模式，因为在升级期间所有服务都必须启动。
6. 升级和验证成功后，通过运行以下命令在节点上恢复备份计划：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

回滚错误

准备

1. 创建一个单独的文件夹来存储旧捆绑包，并在该文件夹中执行以下操作。
2. 在所有节点上下载并解压安装程序的旧版本 (installer.zip)。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
3. 创建 restore.json 文件并将其复制到所有节点。
4. 验证主节点上的以下位置是否存在 etcd 备份数据：/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots
   • etcdBackupPath - 这与启用备份的 node-name 时在 backup.json 中指定的相同；
5. node-name - 主服务器虚拟机的主机名。

集群清理

1. 复制并运行专用脚本，以卸载该节点上的所有内容。对所有节点执行此操作。有关详细信息，请参阅故障排除页面中的如何安装集群一节。
2. 将所有 UiPath 数据库还原到升级前创建的较旧备份。

在服务器节点上还原基础架构

1. 连接到主服务器。这应与您在升级期间选择的服务器节点相同。
2. 通过运行以下命令还原基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. 通过 SSH 逐一连接到其余服务器节点。
4. 通过在服务器节点上逐一运行以下命令，还原这些节点上的基础架构。不支持并行执行它们。

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

在代理节点上还原基础架构

1. 通过 SSH 连接到每个代理虚拟机。
2. 通过运行以下命令在这些节点上恢复基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

还原卷数据

1. 通过 SSH 连接到主服务器。
2. 转到较新的安装程序文件夹。
   注意：先前的基础架构还原命令使用旧的安装程序执行，以下命令使用新的安装程序捆绑包执行。
3. 通过运行以下命令在集群上禁用维护模式：

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. 通过运行以下命令验证是否已禁用维护模式：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. 将基础架构还原阶段使用的 restore.json 文件复制到新的安装程序捆绑包文件夹。
6. 通过执行以下命令，从新的安装程序捆绑包运行卷还原：

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. 还原完成后，请验证是否一切都已还原且工作正常。
8. 在升级过程中，主节点上的计划备份被禁用。要再次启用它们，请运行以下命令：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

离线多节点 HA 就绪生产模式

准备

1. 标识满足离线安装的磁盘要求的任何服务器（非代理）。在本文档中称为主服务器。

   如果您使用的是自签名证书，请运行以下命令：

   <h3>Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./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</h3>

2. 在所选服务器上下载完整的离线捆绑包 (sf.tar.gz)。
3. 在所有其他节点上下载仅基础架构离线捆绑包 (sf-infra.tar.gz)。
4. 在所有节点上下载并解压新的安装程序 (installer.zip)。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
5. 使原始 cluster_config.json 在服务器上可用。
6. 生成新的 cluster_config.json 文件，如下所示：
   • 如果您有旧的“cluster_config.json”文件，请使用以下命令从集群生成配置文件：

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • 如果您没有旧的 cluster config 文件，请运行以下命令：

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

7. 将此 cluster_config.json 复制到所有节点上的安装程序文件夹。

执行

维护和备份

1. 确保您在集群上启用了备份。
2. 通过 SSH 连接到其中一个服务器节点。
3. 通过运行以下命令，验证集群中所有所需的卷是否都有备份：

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

   注意：备份可能需要一些时间，因此请等待大约 15 至 20 分钟，然后再次验证卷备份。
4. 将集群置于维护模式，如下所示：
5. 执行以下命令：

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. 通过运行以下命令验证集群是否处于维护模式：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. 创建 SQL 数据库备份。

升级服务器上的基础架构

1. 通过 SSH 连接到每台服务器。
2. 通过运行 sudo su - 成为根用户。
3. 在所有服务器节点上执行以下命令：

   /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

   请注意：此命令还会创建集群状态的备份，并暂停所有其他计划的备份。

升级代理的基础架构

1. 通过 SSH 连接到每台服务器。
2. 通过运行 sudo su - 成为根用户。
3. 执行以下命令：

   /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

在主服务器上执行其余的升级

1. 通过 SSH 连接到主服务器。
2. 通过运行 sudo su - 成为根用户。
3. 删除补丁 json 文件中的 redis 部分。
   由于升级过程中存在已知问题，我们需要手动编辑/opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json文件。 此问题已在 2022.4 版本中修复。
   为此，请使用文本编辑器打开文件，并删除第 22 到 25 行以及第 21 行中的结尾, ：

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   更改后，文件应如下所示：

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. 通过运行以下命令升级结构：

   /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

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

   首先，您需要连接到身份服务器并检索安装令牌。 然后复制此令牌并将其粘贴到“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

   注意：此命令将禁用您在升级前启用的维护模式，因为在升级期间所有服务都必须启动。
6. 升级和验证成功后，通过运行以下命令在节点上恢复备份计划：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

回滚错误

准备

1. 创建一个单独的文件夹来存储旧捆绑包，并在该文件夹中执行以下操作。
2. 在所有节点上下载并解压旧版本的安装程序 (installer.zip)。
   注意：通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。
3. 创建 restore.json 文件并将其复制到所有节点。
4. 验证主服务器上的以下位置是否存在 etcd 备份数据：/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots
   • etcdBackupPath - 这与启用备份的 node-name 时在 backup.json 中指定的相同；
   • node-name - 主服务器虚拟机的主机名。

集群清理

1. 复制并运行专用脚本，以卸载该节点上的所有内容。对所有节点执行此操作。有关详细信息，请参阅故障排除页面中的如何安装集群一节。
2. 将所有 UiPath 数据库还原到升级前创建的较旧备份。

在服务器节点上还原基础架构

1. 连接到主服务器（与升级期间选择的服务器相同）。
2. 通过运行以下命令还原基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. 通过 SSH 逐一连接到其余服务器节点。
4. 通过运行以下命令在这些节点上恢复基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

   注意：在服务器节点上逐一运行此命令。不支持并行执行它们。

在代理节点上还原基础架构

1. 通过 SSH 连接到每个代理虚拟机。
2. 通过运行以下命令在这些节点上恢复基础架构：

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

还原卷数据

1. 通过 SSH 连接到主服务器。
2. 转到新的安装程序文件夹。
   注意：先前的基础架构还原命令使用较旧的安装程序执行，以下命令使用较新的安装程序捆绑包执行。
3. 通过运行以下命令在集群上禁用维护模式：

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. 通过执行以下命令验证维护模式是否已禁用：

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. 将基础架构还原阶段使用的 restore.jsonfile 复制到新的安装程序捆绑包文件夹。
6. 通过执行以下命令，从较新的安装程序捆绑包中还原卷：

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. 还原完成后，请验证是否一切都已还原且工作正常。
8. 在升级过程中，主节点上的计划备份被禁用。要再次启用它们，请运行以下命令：

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

将 Ceph 从 16.2.6 降级到 15.2.9

有关降级 Ceph 的更多信息，请查看 Automation Suite 指南中的将Ceph 从 16.2.6 降级到 15.2.9 。