离线多节点 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

     备注：

     See Advanced installation experience to fill up the remaining parameters.

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

执行

维护和备份

1. Make sure you have enabled the backup on the cluster. For details, see Backing up and restoring the cluster.

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
   

Execute the Rest of the Upgrade on the Primary Server

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
   

Rollback on Error

准备

1. 创建一个单独的文件夹来存储旧捆绑包，并在该文件夹中执行以下操作。

2. 在所有节点上下载并解压旧版本的安装程序 (installer.zip)。

   备注：

   通过运行 sudo chmod 755 -R <installer-folder> 授予文件夹适当的权限。

3. Create restore.json file and copy it to all the nodes. For details, see Backing up and restoring the cluster.

4. 验证主服务器上的以下位置是否存在 etcd 备份数据：/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots

   • etcdBackupPath - 这与启用备份的 node-name 时在 backup.json 中指定的相同；
   • node-name - 主服务器虚拟机的主机名。

集群清理

1. Copy and run the dedicated script to uninstall everything from that node. Do this for all the nodes. For details, see Troubleshooting.
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
   

Restore Volumes Data

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