1. 概述编辑
2. 升级前准备工作编辑
升级前需进行一些升级的准备工作，请参考文档：升级前准备工作
3. 单节点升级编辑
非 web 集群升级 BI 工程步骤如下：
3.1 安装插件「BI升级工具」
1）下载插件。插件获取请联系技术支持（800049425）。
2）安装插件方法请参见：插件管理
安装完插件后，进行单节点升级，视频操作步骤如下：
详细步骤截图，文档说明如下文所示：
3.2 阅读升级注意事项
勾选阅读完上述注意事项之后，可以点击「下一步」进行，如下图所示：
系统会跳出备份提示界面，点击「确定」如下图所示：
如果未进行备份，请参考本文第 2 节。
3.3 选择升级类型
工具会检测当前系统版本以及 jar 时间，并推荐可用的升级类型。
升级至最新版本路线图为：5.1历史版本 → 5.1.1版本 → 5.1.2_历史版本 → 5.1.2_jar2020-07-17版本 → 5.1.5及后续版本
阅读「升级类型介绍」后，根据需要选择合适的升级类型后，继续点击「下一步」，如下图所示：
注：升级 5.1.5-纯直连版本需联系技术支持 QQ（800049425）。
若选择升级类型后，升级的目标版本界面没有「下一步」，则直接点击「执行」，进行下一步操作，可直接跳转至本文 3.4 节进行操作。界面如下图所示：
3.3.1 表模式兼容调整说明
注：仅5.1.2升级到5.1.5模式有此步骤
了解兼容说明后，导出表后，继续点击「下一步」，如下图所示：
兼容说明：
①FIneBI5.1.5版本，将对直连模式和spider模式进行拆分，将不再支持直连模式表和抽取模式表建立关联关系，不再支持抽取和直连混用的自助数据集。对于现有的关联与混用数据表，升级过程中将自动检索现存的所有「混用模式数据表」；并找到这些数据表的「直连模式的父表」，通过复制SQL数据集的方式，对这些父表进行拷贝，复制其数据结果；来实现「抽取」与「直连」模式的分离调整。具体方式如图所示：
②与此同时，直连模式的数据表将不再支持【自循环列】、【行列转换】、【更改字段类型】、【排序】、【自定义分组】、【跨数据源关联】等操作，以下使用了这些功能的数据表将被转至为spider模式。
3.3.2 关联与权限兼容说明
注：仅5.1.2升级到5.1.5模式有此步骤
了解兼容说明后，导出相关数据，点击「执行」进行配置升级，如下图所示：
兼容说明：
①FIneBI5.1.5版本，将对直连模式和spider模式进行拆分，将不再支持直连和spider表、直连自助数据集之间建立关联关系，升级后以下数据表之间的关联关系将丢失。如果这些该关联路径上，存在跨越直连和抽取两种模式的权限配置；那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作。
②权限失效情况如下：1、直连模式的数据表，权限设置时使用了抽取模式的表，进行权限配置。2、抽取模式的数据表，权限设置时使用了直连模式的表，进行权限配置。
3.4 执行配置升级
点击「执行」会进入配置自动升级的界面，如下图所示：
配置升级完成后，会自动跳转下一步操作；并且会自动生成Excel格式升级报告说明，如下图所示：
3.5 上传jar文件
1）输入完信息后，点击「执行」进行jar文件替换，如下图所示：
当前工程 JAR 路径：%FineBI%/webapps/webroot/WEB-INF/lib
上传 zip 文件包：示例为%FineBI%/webapps/webroot/WEB-INF/exchangeJars（zip 包可联系技术支持获取： QQ：800049425）
当前工程的启动路径：%FineBI%/bin/
注：5.1.1-5.1.2 可能会出现下面的内容：
当前工程的启动 JAR路径：%FineBI%/lib（只有exe安装的才有，若是 BI 部署到了其他容器中，则不需要做这个步骤。）
新 JAR 路径：%FineBI%/exchangeJars（只有exe安装的才有，若是 BI 部署到了其他容器中，则不需要做这个步骤。 Jar 包获取请点击：lib）
注意事项：
①上传zip文件包时，直接将「.zip文件」从本地 pc 上传即可，无需解压放置到服务器上。上传成功后路径中将显示/……/WEB-INF/exchangeJars字样。
②Jar包上传受网络传输影响，可能需要稍等几分钟才能完成上传；平均上传时间会在10min以内完成。
③如果多次上传Jar包失败或等待超时，请手动将解压后的新jar文件放置在工程部署服务器WEB-INF\lib路径下，并立即重启。
④如果当前工程jar路径中存在空格或「%」，将会影响 Jar 包的上传与替换；如遇该情况，请手动将解压后的新jar文件放置在工程部署服务器WEB-INF\lib路径下，并立即重启。
⑤当前工程启动路径会获取部署路径下的/……/bin/路径，目前仅支持Tomcat和exe部署的自动获取；如果获取路径空白，不会影响下一步「执行系统升级」，在「完成」后自行重启即可。
2）点击「执行」后，会出现提示界面。点击「确定」执行操作，提示界面如下图所示：
若未进行备份，可参考本文第 2 节。
3.6 完成
如果升级成功则会提示界面如下图所示：
完成界面详情：
系统升级成功，系统将在10s之后立即重启；第一次重启时间较长，请耐心等待。--------//（10s之后执行重启脚本）
注 1 ：自动重启功能仅支持 Tomcat 和 exe 部署方式。如果是 Weblogic、Wildfly(JBoss)、Websphere、Docker 服务器部署，请自行立即重启
注 2 ：如果重启功能未执行，请自行立即重启。
如果升级失败则会提示：
系统升级失败，请联系BI技术支持；QQ公众号：800049425 定位解决问题。
4. web 集群升级编辑
集群环境有多个节点，处理不同的请求，在开启多个节点的情况下，上述三个功能的请求会被转发到不同的节点处理，会导致升级有误；因此对于集群，我们提供以下两个方案：
4.1 方案一：在开启多个节点升级
1）集群仅使用升级工具的「执行配置升级」功能，不要使用「上传jar文件」功能。步骤详情可参考本文 3.1 -3.4 节。
2）升级操作过程正常流转至该页面时，不要做任何操作。如下图所示：
3）关闭正在运行的 FineBI 工程。
4）拷贝并替换 jar 文件。
将升级的 jar 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包。
5）手动重启 BI 工程。
4.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 。
5. 验证升级效果编辑
系统重启完成后，查看「管理系统>注册管理」中的版本号和 jar 日期。如果已经变更为新版本，则说明升级成功，如下图所示：
继续检测模板是否都可以正常预览，如果升级过程中遇到其他问题，请联系 BI 技术支持，QQ公众号：800049425 定位解决问题。
6. 升级回退编辑
7. 升级后功能变化编辑
升级后的功能变化：2020-08-04 更新日志