1.1 确认版本

升级版本确认及每个版本对应的文档索引参见：FineBI 版本说明

本文介绍 5.1.x 单节点升级指南，集群 5.1.x 升级指南参见文档：「集群」5.1.x升级指南

1.2 升级流程

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

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

3.1 安装插件「BI升级工具」

1）下载插件。插件获取请前往 【服务平台>在线支持】。

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-纯直连版本建议前往 【服务平台>在线支持】。

• 若选择升级类型后，升级的目标版本界面没有「下一步」，则直接点击「执行」，进行下一步操作，可直接跳转至本文 3.4 节进行操作。界面如下图所示：

3.3.1 表模式兼容调整说明

注：仅5.1.2升级到5.1.5模式有此步骤

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

3.3.2 关联与权限兼容说明

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

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

3.4 执行配置升级

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

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

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 包可联系技术支持获取， 【服务平台>在线支持】）

• 当前工程的启动路径：%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 ：如果重启功能未执行，请自行立即重启。

如果升级失败则会提示：

系统升级失败，建议前往 【服务平台>在线支持】定位解决问题。

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

继续检测模板是否都可以正常预览，如果升级过程中遇到其他问题，建议前往 【服务平台>在线支持】定位解决问题。

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

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

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

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

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