5.0&5.1.1升级指南

  • 文档创建者:doreen0813
  • 编辑次数:35次
  • 最近更新:Roxy 于 2020-06-30
  • 1. 概述

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

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

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

    2. 同版本升级

    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 包

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

    222

    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 技术支持(QQ:800049425)获取 5.1 升级 JAR 包:fine-accumulator-10.0.jarfine-activator-10.0.jarfine-bi-adapter-5.1.jarfine-bi-datamine-5.1.jarfine-bi-datamine-third-5.1.jarfine-bi-engine-spider-5.1.jarfine-bi-engine-third-5.1.jarfine-bi-foundation-5.1.jarfine-core-10.0.jarfine-datasource-10.0.jarfine-decision-10.0.jarfine-decision-bi-10.0.jarfine-decision-report-10.0.jarfine-report-engine-10.0.jarfine-schedule-10.0.jarfine-schedule-bi-10.0.jarfine-schedule-report-10.0.jarfine-swift-log-adaptor-10.0.jarfine-third-10.0.jarfine-webui-10.0.jar,将 JAR 包拷贝到对应目录%FineBI%/webapps/webroot/WEB-INF/lib下替换掉原先的 JAR 包,如下图所示:

    222

    2.2.6 重启 FineBI 

    替换完成后重启 FineBI 。

    3. 5.0 升级至 5.1 版本

    3.1 非分布式步骤

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

    3.1.1 确认版本

    确认当前版本为 5.0 版本。

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

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

    3.1.3 停止 BI 进程

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

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

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

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

    3.1.5 拷贝 JAR 包

    进入目录%FineBI%/webapps/webroot/WEB-INF/lib,删除fine-accumulator-10.0.jarfine-activator-10.0.jarfine-bi-adapter-5.0.jarfine-bi-engine-spider-5.0.jarfine-bi-engine-third-5.0.jarfine-bi-foundation-5.0.jarfine-core-10.0.jarfine-datasource-10.0.jarfine-decision-10.0.jarfine-decision-bi-10.0.jarfine-decision-report-10.0.jarfine-report-engine-10.0.jarfine-schedule-10.0.jarfine-schedule-bi-10.0.jarfine-schedule-report-10.0.jarfine-swift-log-adaptor-10.0.jarfine-third-10.0.jarfine-webui-10.0.jarREngine.jarRserve.jartimeseriesForecasting-1.1.27.jarweka.jar共22个 JAR 文件。

    将获取的 5.1 JAR 拷贝至该目录,拷贝后的文件夹如下图所示:

    222

    3.1.6 升级后检查

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

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

    3.1.7 重启 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 注意事项

    3.2.1 联动分组

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

    3.2.2 水印

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

    4. 升级 5.1 至 5.1.1 版本

    4.1 升级步骤

    4.1.1 确认版本

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

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

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

    4.1.3 停止 BI 进程

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

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

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

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

    4.1.5 拷贝 JAR 包

    联系技术支持(QQ:800049425)获取 5.1.1 JAR 包,拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中,替换原先的 JAR 包;

    4.1.6 替换启动器文件

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

    Windows:lib-win64.zip

    Mac:lib-mac.zip

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

    4.1.7 升级系统 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 该问题在后续版本将解决。

    4. 升级回退

    若出现升级失败需要回退原来的旧版本。详情参见:升级后回退至原版本 

    附件列表


    主题: 入门指南
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!