1.1 确认版本

请参见升级索引查看升级所对应的版本：升级指南索引

1.2 升级流程

升级前需进行一些升级的准备工作，请参考文档：5.1.x升级前准备工作

集群环境有多个节点，处理不同的请求，在开启多个节点的情况下，上述三个功能的请求会被转发到不同的节点处理，会导致升级有误；因此对于集群，我们提供以下两个方案：

3.1 方案一：在开启多个节点升级

1）集群仅使用升级工具的「执行配置升级」功能，不要使用「上传jar文件」功能。步骤详情可参考本文 3.1 -3.4 节。

2）升级操作过程正常流转至该页面时，不要做任何操作。如下图所示：

3）关闭正在运行的 FineBI 工程。

4）拷贝并替换 jar 文件。

将升级的 jar 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包。

5）手动重启 BI 工程。

3.2 方案二：只开一个节点升级

要求：需要操作人员对环境配置比较熟悉。

1）使用升级工具的所有功能，正常升级完成一个节点。步骤详情请参考本文第 3 节。

2）其他节点手动替换跟升级节点相同的 jar 包。

将升级的 jar 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包。

3）重启 BI 工程。

注 1：开哪个节点升级取决于用户的环境配置，有些用户的配置复杂，对节点启动顺序有要求，或者设置了不同节点处理不同的请求，节点不是可以轻易关闭的等等。

注 2：nginx 有文件传输大小和时间的限制，「上传JAR文件」页面的自动换jar功能，上传的 jar 包比较大时，可能会超出 ngnix 的限制，导致上传 jar 失败，此时也手动换 jar ，参考 3.1 节。