历史版本28 :5.0-5.1.1升级指南 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

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

本文详细介绍2020-01-15 前 5.0&5.1 版本升级步骤。

1.1 注意事项

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

  • 2019-08-16 之前安装/升级的 4.1 及 5.1 版本 FineBI ，由于内置地图文件版本较老，需要手动更新，详情参见：地图文件更新 。

2. 同版本升级编辑

2.1 对 5.0 同版本升级

2.1.1 确认版本

确认当前版本为 5.0 版本。

2.1.2 停止 BI 进程

升级前先检查 FineBI 是否正在运行，保证在 FineBI 关闭状态下进行升级。

2.1.3 备份工程

升级前请备份好 webroot ，webroot 路径为%FineBI%\webapps\webroot。若升级前配置了外接数据库，需要同时进入管理系统>智能运维>备份还原，点击手动备份，备份平台配置，详情参见：备份还原 。

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

2.1.4 升级前检查

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

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

2.1.5 拷贝 JAR 包

联系 FineBI 技术支持（QQ：800049425）获取 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 包，如下图所示：

222

2.1.6 重启 FineBI 

替换完成后重启 FineBI 。

2.2 对 5.1 同版本升级

2.2.1 确认版本

确认当前版本为 5.1 版本，可以通过查看 JAR 包日期确定 BI 的版本，参考 FineBI 版本说明。

2.2.2 停止 BI 进程

升级前先检查 FineBI 是否正在运行，保证在 FineBI 关闭状态下进行升级。

2.2.3 备份工程

升级前请备份好 webroot ，webroot 路径为%FineBI%\webapps\webroot。若升级前配置了外接数据库，需要同时进入管理系统>智能运维>备份还原，点击手动备份，备份平台配置，详情参见：备份还原 。

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

2.2.4 拷贝 JAR 包

联系 FineBI 技术支持（QQ：800049425）获取 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 包，如下图所示：

222

2.2.5 重启 FineBI 

替换完成后重启 FineBI 。

3. 5.0 升级至 5.1 版本编辑

3.1 非分布式步骤

FineBI5.0 升级到 5.1 相比同版本之间步骤多。

3.1.1 确认版本

确认当前版本为 5.0 版本，可以通过查看 JAR 包日期确定 BI 的版本，参考 FineBI 版本说明。

3.1.2 停止 BI 进程

升级前先检查 FineBI 是否正在运行，保证在 FineBI 关闭状态下进行升级。

3.1.3 备份工程

升级前请备份好 webroot ，webroot 路径为%FineBI%\webapps\webroot。

若升级前配置了外接数据库，需要同时进入管理系统>智能运维>备份还原，点击手动备份，备份平台配置，详情参见：备份还原 。

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

3.1.4 拷贝 JAR 包

进入目录%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 拷贝至该目录，拷贝后的文件夹如下图所示：

222

3.1.5 升级后检查

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

222

2）若为 Windows 或者 Mac OS 系统下部署的安装版 FineBI ，则需下载 fine-bi-starter.jar，将其替换至%FineBI%/lib下。

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

3.1.6 重启 FineBI 

升级完成后重启 FineBI 。

3.2 分布式步骤

除进行 3.1 节步骤之外，分布式部署还需增加步骤如下：

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

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

   222

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

222

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. 升级 5.1 至 2019-07 5.1 版本编辑

4.1 升级步骤

4.1.1 确认版本

确认当前版本为 5.1 版本，可以通过查看 JAR 包日期确定 BI 的版本，参考 FineBI 版本说明。若为 5.0 升级至 5.1 2019-07 版本，需要先参考本文第 3 节内容，将 5.0 升级至 5.1 版本，再按照如下步骤升级至 2019-07 版本。

4.1.2 停止 BI 进程

升级前先检查 FineBI 是否正在运行，保证在 FineBI 关闭状态下进行升级。

4.1.3 备份工程

升级前请备份好 webroot ，webroot 路径为%FineBI%\webapps\webroot。若升级前配置了外接数据库，需要同时进入管理系统>智能运维>备份还原，点击手动备份，备份平台配置，详情参见：备份还原 。

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

4.1.4 拷贝 JAR 包

联系技术支持（QQ：800049425）获取 2019-07 5.1 JAR 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包；

4.1.5 替换启动器文件

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

Windows：lib-win64.zip

Mac：lib-mac.zip

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

4.1.6 升级系统 GCC

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

4.2 注意事项

4.2.1 数据集

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

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

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

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

4.2.2 仪表板

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

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

4.2.3 其他

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

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

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

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

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