5.0-5.1.1版本升级指南

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

本文详细介绍 5.0&5.1.1 版本升级步骤。

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

2.1 对 5.0 同版本升级

2.1.1 确认版本

确认当前版本为 5.0 版本。

2.1.2 配置外接数据库的工程进行备份

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

2.1.3 停止 BI 进程

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

2.1.4 配置内置数据库的工程进行备份

若升级前工程没有配置过外接数据库，则需要备份好 webroot 文件夹，在 webroot 路径%FineBI%\webapps\webroot下拷贝工程。

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

2.1.5 升级前检查

• 若为从 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.6 拷贝 JAR 包

若您是未联系帆软销售经理的个人用户，可致电 400-8118890 转1 与帆软商务联系获取相关资讯；若您已与帆软销售经理有对接，可通过 FineBI 技术支持（请前往 【服务平台>在线支持】）获取新版本 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 包，如下图所示：

注：如果您是个人用户，可从官网下载对应版本工程，将%FineBI%/webroot/WEB-INF/lib 下的 JAR 包拷贝并替换到需要升级的 BI 工程中。

2.1.7 重启 FineBI 

替换完成后重启 FineBI 。

2.2 对 5.1 同版本升级

2.2.1 确认版本

确认当前版本为 5.1 版本。

2.2.2 配置外接数据库的工程进行备份

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

2.2.3 停止 BI 进程

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

2.2.4 配置了内置数据库的工程进行备份

若升级前工程没有配置过外接数据库，则需要备份好 webroot 文件夹，在 webroot 路径%FineBI%\webapps\webroot下拷贝工程。

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

2.2.5 拷贝 JAR 包

请前往 【服务平台>在线支持】联系 FineBI 技术支持获取 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 包，如下图所示：

2.2.6 重启 FineBI 

替换完成后重启 FineBI 。

3.1 非分布式步骤

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

3.1.1 确认版本

确认当前版本为 5.0 版本。

3.1.2 升级前备份

为了升级失败后能够顺利回退到原版本，需要进行一些备份。

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

3.1.3 停止 BI 进程

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

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

注：如果您是个人用户，可从官网下载对应版本工程，将%FineBI%/webroot/WEB-INF/lib 下的 JAR 包拷贝并替换到需要升级的 BI 工程中。

3.1.5 升级后检查

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

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 这个文件夹删除。否则由于冲突工程会无法启动。

4）将 BI 从 5.0 升级到 5.1 及以上的版本时，连接 FineDB 数据库，查看  FineBI 内置的数据库中表 fine_conf_entity 的「ID」字段中是否有这个值：DistributedOptimizationConfig.spiderConfig.spider_namenode_mode 。若有，则需将它对应的 「Value 」值改为auto ;若无该这个值，则需要增加这个值并将对应的 「Value」 值设置为auto 。

3.1.6 重启 FineBI 

升级完成后重启 FineBI 。

3.2 分布式步骤

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

若为 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 注意事项

3.2.1 联动分组

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

3.2.2 水印

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

4.1 升级步骤

4.1.1 确认版本

确认当前版本为 5.1 版本，若为 5.0 升级至 5.1.1 版本，需要先参考本文第 3 节内容，将 5.0 升级至 5.1 版本，再按照如下步骤升级至 5.1.1 版本。

4.1.2 升级前备份

为了升级失败后能够顺利回退到原版本，需要进行一些备份。

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

4.1.3 停止 BI 进程

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

4.1.4 拷贝 JAR 包

请前往 【服务平台>在线支持】联系技术支持获取 5.1.1 JAR 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包；

4.1.5 替换启动器文件

若为 Windows 或 Mac 系统，需要更新启动器文件。下载：fine-bi-starter.jar

解压后将其中的 JAR 包拷贝至FineBI目录%FineBI%/lib下，替换原先的 JAR 。

4.1.6 升级系统 GCC

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

4.2 注意事项

4.2.1 数据集

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

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

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

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

4.2.2 仪表板

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

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

4.2.3 用户

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

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

4.2.4 其他

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

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

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

若出现升级失败需要回退原来的旧版本。

升级回退请参见：跨版本升级回退至原版本