1. 概述
2. 升级前准备工作
升级前需进行一些升级的准备工作，请参考文档：5.1.x升级前准备工作
3. 单节点升级
非 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 ：如果重启功能未执行，请自行立即重启。
如果升级失败则会提示：
系统升级失败，建议前往 【服务平台>在线支持】定位解决问题。
4. 验证升级效果
系统重启完成后，查看「管理系统>注册管理」中的版本号和 jar 日期。如果已经变更为新版本，则说明升级成功，如下图所示：
继续检测模板是否都可以正常预览，如果升级过程中遇到其他问题，建议前往 【服务平台>在线支持】定位解决问题。
5. 升级回退
6. 升级后功能变化
升级后的功能变化：更新日志
注：根据自己对应的 JAR 包和版本查看该日期及之前的功能变化。
