1.1 版本

1.2 适用版本

适用于 5.1.5 之后的版本升级。

1.3 升级前准备

升级前请先参看准备工作：5.1.5后的版本升级前准备工作

2.1 判断数据库类型

进入「管理系统>系统管理>常规」可以看到是否使用了外接数据库，如下图所示：

• 如果显示「待配置」：则数据库类型为内置数据库

• 如果显示「已配置」：则数据库类型为外置数据库

2.2 进行系统备份

注：版本升级不支持直接回退，请务必进行备份完成后再执行升级；5.1.14 以及之后的版本会检测配置与 JAR 版本是否一致。

2.2.1 内置数据库系统备份

1）关闭 FineBI 。

2）内置数据库的工程备份，备份好「webroot」文件夹，在 webroot 路径：%FineBI%\webapps\webroot下拷贝工程，如下图所示：

注1：备份应以压缩文件形式存放，或者把备份文件拷贝到非工程所在目录，确保 Web 容器里只有一个名为 webroot 的工程。

注2：如果 webroot 太大，则备份 WEB-INF 文件夹，若还是太大，备份%FineBI%/webroot/web-inf 下的dashboards、embed、lib、plugins、reportlets五个文件夹。

2.2.2 外接数据库系统备份

1）备份 webroot 。在 webroot 路径：%FineBI%\webapps\webroot下拷贝工程，如下图所示：

注：如果 webroot 太大，则备份 WEB-INF 文件夹，若还是太大，备份%FineBI%/webroot/web-inf下的dashboards、embed、lib、plugins、reportlets五个文件夹。

2）备份外接数据库。进入「管理系统>智能运维>备份还原」，在「平台配置」、「报表模板」、「BI模板」、「jar 包」、「插件」 Tab 栏下分别点击「手动备份」，更多详情信息见：备份还原

自动备份方法：

若不想每次进行都手动进行备份，5.1.13 之后的版本支持在升级过程中自动进行备份。

使用 FINE_CONF_ENTITY可视化配置 插件，点击「管理系统>系统工具」，选择「自定义参数配置」，输入系统参数名「BIUpdateConfig.autoBackup」和系统参数值「true」，点击保存，如下图所示：

则会在升级时自动判断是否有升级当天的外接数据库备份，若没有则会在升级前自动进行备份。

注：只备份外接数据库仅仅用于防止忘记备份外接数据库，若需要回退还是需要手动备份的 webroot 文件夹，详情参见：跨版本升级后回退至原版本。

2.2 更换新版本的 JAR 包

2.2.1 停止 BI 工程

关闭正在运行的 FineBI 工程。

2.2.2 拷贝 JAR 包

联系 FineBI 技术支持（QQ：800049425）获取 JAR 包，将 JAR 包拷贝到对应目录%FineBI%/webapps/webroot/WEB-INF/lib下替换掉原先的 JAR 包，如下图所示：

也可以使用升级工具插件自动替换 JAR 包，详情参见 ：升级工具插件升级

2.3 重启 FineBI 

替换完成后重启 FineBI 即可。