1.1 确认版本

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

本文介绍 5.1.1 升级到 5.1.2、5.1.3、5.1.5 版本单节点，集群 5.1.x 升级指南参见文档：「集群」5.1.1-5.1.5升级指南

1.2 升级流程

升级前需进行一些升级的准备工作，请参考文档：5.1.1-5.1.5升级前准备工作

非 web 集群升级 BI 工程步骤如下：

注：若用户从 5.1.2-5.1.5 升级，且使用了nginx转发，nginx有文件传输大小和时间的限制，可能会出现插件安装失败，jar包上传失败的问题，IP+端口访问可以避免。

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模式有此步骤

了解「表模式兼容调整说明」后，导出表后，继续点击「下一步」，如下图所示：

3.3.2 关联与权限兼容说明

注：仅 5.1.2 升级 5.1.5 有此步骤，且配置升级只能执行一次，不能多次执行。

了解「关联与权限兼容说明」后，导出相关数据，点击「执行」进行配置升级，如下图所示：

3.4 执行配置升级

3.4.1 操作步骤 

点击「执行」会进入配置自动升级的界面，如下图所示：

配置升级完成后，会自动跳转下一步操作；并且会自动生成 Excel 格式「升级报告说明」，如下图所示：

3.4.2 注意事项

1）执行配置升级的步骤会自动检测，外置数据库权限。

自动检查%FineBI%/webapps/webroot/WEB-INF/config下的db.properties的配置是否正确， db.properties 中下图位置配置必须为 update：

插件自动检测外接数据库用户数据库 DDL 权限，用户必须要有 DDL 权限。外接数据库用户如下图所示：

如果上述两项任意一项检测不过，报错均如下图所示：

解决方法：运维人员去检查对应的权限。

如果确认是第（2）项检测不过，可以查看 fanruan.log，搜索关键字 create db table or insert data failed ，查看数据库详细报错信息。

2）若自助数据集数据处理表依赖了数据分析表，报错提示如下图所示：

解决方法：联系技术支持解决问题 QQ（800049425）。

3.5 上传jar文件

3.5.1 自动换 JAR

1）先相信阅读「上传Jar文件」的注意事项，再输入完信息后，点击「执行」进行 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）

2）点击「执行」后，会出现提示界面。点击「确定」执行操作，提示界面如下图所示：

若未进行备份，可参考本文第 2 节。

3.5.2 手动换 JAR

注 1：通常情况下，按照升级工具指引步骤操作即可。如果上传 Jar 文件失败，可选择手动换 Jar 。

注 2：5.1.2 升级 5.1.5，配置升级只能执行一次，不能多次执行。如果换jar失败，不用再执行前面的步骤，直接手动换 jar 即可。

操作失败后，手动换 Jar 步骤如下：

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

2）拷贝并替换 jar 文件。

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

3）手动重启 BI 工程。

结束可跳转第 4 节，验证升级效果。

3.6 完成

如果升级成功则会提示界面如下图所示：

完成界面详情：

系统升级成功，系统将在10s之后立即重启；第一次重启时间较长，请耐心等待。--------//（10s之后执行重启脚本）

注 1 ：自动重启功能仅支持 Tomcat 和 exe 部署方式。如果是 Weblogic、Wildfly(JBoss)、Websphere、Docker 服务器部署，请自行立即重启

注 2 ：如果重启功能未执行，请自行立即重启。

如果升级失败则会提示：

系统升级失败，请联系 BI 技术支持（QQ：800049425 ）定位解决问题。

系统重启完成后，查看「管理系统>注册管理」中的版本号和 jar 日期。如果已经变更为新版本，则说明升级成功，如下图所示：

继续检测模板是否都可以正常预览，如果升级过程中遇到其他问题，请联系 BI 技术支持（QQ：800049425 ）定位解决问题。

注意事项：

只有5.1.5之后的版本才会显示小版本号。之前的版本显示为 5.1.0 ，可以根据 JAR 的日期来确定版本。

下表为每个小版本第一次发布的 JAR 包日期。若在 JAR 包日期在两个版本中间，则为较早的版本。

例如，下图是 2020.08.04 的 JAR ，因此是5.1.5的版本。

若出现升级失败等原因，需要回退原来的旧版本。

升级回退请参见：跨版本升级回退至原版本

升级后的功能变化：更新日志

注：根据自己对应的 JAR 包和版本查看该日期及之前的功能变化。