1.1 版本

1.2 适用版本

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

2.1 进行系统备份

升级前请确认备份好 webroot 文件夹，如果配置了 外接数据库 请同时备份平台配置。系统升级过程都会顺利进行，为确保万无一失，做好系统备份可以在突发情况发生时，快速切换。

用户需要参照 跨版本升级后回退至原版本 判断自己配置的是内置数据库还是外接数据库，并对照文档备份需要的内容。

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

2.1.1 内置数据库备份

1）关闭 FineBI 。

2）内置数据库的工程备份：若升级前工程没有配置过外接数据库，则需要备份好「webroot」文件夹，在 webroot 路径：%FineBI%\webapps\webroot下拷贝工程。如下图所示：

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

2.1.2 外接数据库备份

通用备份方式：

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

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

自动备份：

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

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

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

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 即可。