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

准备

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

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

   ### 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

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. 要验证 Automation Suite 是否运行正常，请运行：

   kubectl get applications -n argocd

5. 将集群置于维护模式，如下所示：
   1. 执行以下命令：

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

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

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

6. 创建 SQL 数据库备份。

升级服务器上的基础架构

注意： 不支持同时升级服务器和代理上的基础架构，这将导致错误。 请务必连续执行这些步骤。

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

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

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

   /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