为满足客户的新需求及完善之前版本某些功能在使用中的不足之处，产品也在不断更新中。若需要修复之前版本中存在的一些问题及需要使用新的功能，就需要升级到新版本。

本文详细介绍如何进行版本的升级。

注：FineBI4.1 版本升级至 5.1 版本的操作可参考 4.1-5.1升级指南 。

2019 年 8 月 16 日之前安装/升级的 4.1 及 5.1 版本 FineBI ，由于内置地图文件版本较老，需要手动更新，请参考 地图文件更新 操作。

FineBI 同版本之间升级的时候只需要更新 JAR 包即可，获取 JAR 包有两种方式：一种是联系 FineBI 的技术人员或在线 QQ 获取最新 JAR 包，另外一种是在官网下载对应版本安装包安装后，到%FineBI%/webapps/webroot/WEB-INF/lib下拷贝出需要的 JAR 包。

2.1 对 5.0 同版本升级

联系 FineBI 技术人员获取 5.0 JAR 包：fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-bi-adapter-5.0.jar、fine-bi-engine-spider-5.0.jar、fine-bi-engine-third-5.0.jar、fine-bi-foundation-5.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-bi-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-bi-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar，将 JAR 包拷贝到对应目录%FineBI%/webapps/webroot/WEB-INF/lib下替换掉原先的jar包，如下图所示：

替换前请注意备份原 JAR 包，替换完成后重启 FineBI 即可。

注：若为从 9.15 的 stable 安装包升级到之后版本，除了更新以上jar包外，还需要更换%FineBI%/lib下面的fine-bi-starter.jar；Linux 安装版本，需要直接更换 FineBI 目录下的 JRE：jre.tar.gz；

使用 Tomcat、Weblogic 等容器部署的，从 9.15 的 stable 升级到之后版本，需要将环境上安装的 JDK 的 lib 下面的 tools.jar 拷贝到Tomcat_home/lib或%FineBI%/webapps/webroot/WEB-INF/lib任一位置。

2.2 对 5.1 同版本升级

获取 5.1 升级 JAR 包：fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-bi-adapter-5.1.jar、fine-bi-datamine-5.1.jar、fine-bi-datamine-third-5.1.jar、fine-bi-engine-spider-5.1.jar、fine-bi-engine-third-5.1.jar、fine-bi-foundation-5.1.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-bi-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-bi-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar，将 JAR 包拷贝到对应目录%FineBI%/webapps/webroot/WEB-INF/lib下替换掉原先的 JAR 包（替换前请注意备份），如下图所示：

替换完成后重启 FineBI 即可。

3.1 升级步骤

3.1.1 非分布式步骤

FineBI5.0 升级到 5.1 相比同版本之间步骤多，下面我介绍详细的升级步骤（升级前关闭 FineBI ）：

1）进入目录%FineBI%/webapps/webroot/WEB-INF/lib，删除fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-bi-adapter-5.0.jar、fine-bi-engine-spider-5.0.jar、fine-bi-engine-third-5.0.jar、fine-bi-foundation-5.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-bi-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-bi-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar、REngine.jar、Rserve.jar、timeseriesForecasting-1.1.27.jar、weka.jar共22个 JAR 文件（删除前注意备份）。将获取的 5.1 JAR 拷贝至该目录，拷贝后的文件夹如下图所示：

2）下载 ehcache.db.properties 文件，并将其放入%FineBI%/webapps/webroot/WEB-INF/config目录下（若没有 config 文件夹则新建），如下图所示：

3）备份%FineBI%/webapps/webroot/WEB-INF/embed下的 FineDB 文件夹，若之前做过 数据迁移 ，则在对应数据库下做备份；

4）若为 Windows 或者 Mac OS 系统下部署的安装版 FineBI ，则需下载 fine-bi-starter.jar，将其替换至%FineBI%/lib下（替换前注意备份原文件）；

5）若为 exe 安装的 FineBI5.0，且使用了 phoenix 的驱动，则需要在%FineBI%/webapps/webroot/WEB-INF/lib下找到驱动包phoenix-4.12.0-HBase-1.2-client.jar，并将里面的 javax.servlet 这个文件夹删除。否则由于冲突工程会无法启动。

3.1.2 分布式步骤

除上述步骤之外，分布式部署还需增加步骤如下：

若为 Spider 分布式部署用户，在升级时还需要对集群的配置进行更改，需要给 spark 集群服务添加参数spark.shuffle.service.enabled 并设置为 true ，否则 BI 启动的时候会报错导致无法启动。参数添加步骤如下：

1）打开 ambari 的页面，选中 Spark 服务的标签，并且选中 Configs 标签栏，如图所示：

2）展开 Custom spark2-defaults 标签项，点击 Add Property 按钮，添加如下内容：spark.shuffle.service.enabled=true ，如图所示：

3）添加完成，点击Add按钮，然后重启spark服务即可；

以上升级步骤完成后，重启 FineBI 即可完成升级 5.1 。

3.2 注意事项

1）5.1 取消联动分组功能，5.0升级到5.1后，会依据5.0配置的联动分组给组件配置联动方向；

2） 5.1的 水印功能 不支持 IE11 以下的浏览器，IE11 以下浏览器虽然也有水印，但是面板上什么都操作不了；且该水印功能对定时调度相关文件和数据无效；

3）将 BI 从 5.0 升级到 5.1 及以上的版本时，参考 使用第三方管理软件连接报表内置HSQL数据库FineDB 连接 FineDB 数据库，查看  FineBI 内置的数据库中表 Fine_conf_entity 下是否有DistributedOptimizationConfig.spiderConfig.spider_namenode_mode 字段。若有该字段，则需将该字段下的 Value 值改为auto ;若无该字段，则需要增加该字段并将其 Value 值设置为 auto 。

4.1 升级步骤

注：若为 5.0 升级至 5.1 2019.7 版本，需要先将 5.0 升级至 5.1 版本，再按照如下步骤升级至 2019.7 月版本。

1）获取 2019.7 5.1 的 JAR 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包；

注：换 JAR 前请备份工程 webroot（配置了外接数据库同时备份平台配置）。

2）若为 Windows 或 Mac 系统，需要更新启动器文件。

Windows：lib-win64.zip

Mac：lib-mac.zip

在此处下载对应操作系统的文件，解压后将其中的 JAR 包拷贝至FineBI目录%FineBI%/lib下，替换原先的 JAR ；

3）若使用 Linux 系统，且需使用大数据量的图表展示，则需判断是否需要升级系统 GCC ，参考 图表大数据GCC升级 。

4.2 注意事项

1） 升级后，原普通 BI 设计用户默认兼容为数据分析用户，管理员为数据处理用户。若原 BI 设计用户想要在升级后仍然从数据库添加基础表到业务包中，需要在升级后将其改为数据处理用户，参考 BI设计用户 ；

2）升级后，所有自助数据集都会兼容为数据处理自助数据集，计算无数据量限制，并且可以手动配置关联和权限。建议此前存在更新慢的用户，升级之后重新梳理关联关系，删除不需要的表间关联；

3）5.1 升级到 5.1 2019.7 版本，Sqlite 数据连接创建的 SQL 数据集会更新失败，需要编辑预览之后，再更新才能成功。比如：内置 demo 中业务包>高级报表>订单明细表；

4）若原仪表板非热力点类型的图表采用了热力色方案，且使用了'自动'颜色分配，则有可能导致部分图形渲染为白色，从而导致在白色背景下无法辨识，需更换颜色；

5）定时调度附件选择 pdf ，组件配色与原模板配色不一致，且地图组件可能 doa 该问题在后续版本将解决；

6）使用 IE11 浏览器设置地图配置中的自定义图片，保存无效，该问题在后续版本将解决；

7）图表组件中设置警戒线后，修改指标显示名，警戒线显示错误，在换 JAR 后，需要手动调整；

8）来自不同数据连接之间的实时数据表若关联，会产生内存计算，性能较差，且会有数据量限制。建议这种场景，都设置为抽取数据并关联；

9）自助数据集选择的字段若同时来自于实时数据和抽取数据的表，或者来自不同数据连接的实时数据表，同样性能较差，且会有数据量限制。建议这种场景，原数据表均设置为抽取数据处理；

10）数据处理用户若为实时数据自助数据集配置和任意表的关联，性能和数据量都会存在限制。建议数据处理用户仅配置实时数据基础表的关联，需要进行数据处理的优先在 SQL 中处理；

11）在升级之前，若工程做了数据库迁移，请检查迁移数据库的编码与表 Fine_conf_entity 的编码是否一致，若不一致，先将数据库的编码修改为与 Fine_conf_entity 一致。