5.0-5.1.1升级指南

  • 文档创建者:doreen0813
  • 编辑次数:45次
  • 最近更新:Roxy 于 2021-03-15
  • 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 升级前备份

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

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

    3.1.3 停止 BI 进程

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

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

    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 标签栏,如图所示:

       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 升级前备份

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

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

    4.1.3 停止 BI 进程

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

    4.1.4 拷贝 JAR 包

    联系技术支持(QQ:800049425)获取 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 该问题在后续版本将解决。

    5. 升级回退

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

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

    附件列表


    主题: 产品简介
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-127-81526