FineBI升级指南

编辑
  • 文档创建者:doreen0813
  • 浏览次数:7816次
  • 编辑次数:11次
  • 最近更新:杨子静 于 2019-08-20
  • 1、描述

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

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

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

    2、同版本升级

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

    2.1 5.0同版本升级

    联系FineBI技术人员获取5.0jar包: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、5.0升级5.1

    3.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.1jar拷贝至该目录,拷贝后的文件夹如下图:


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

    分布式增加的步骤:

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

          a)打开ambari的页面,选中Spark服务的标签,并且选中Configs标签栏,如图所示:

       

          b)展开Custom spark2-defaults标签项,点击Add Property按钮,添加如下内容:spark.shuffle.service.enabled=true ,如图所示:


          c)添加完成,点击Add按钮,然后重启spark服务即可;

    7. 以上升级步骤完成后,重启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.7 5.1版本

    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;

    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一致。

    附件列表


    主题: 入门指南
    标签: 暂无标签 编辑/添加标签
    如果您认为本文档还有待完善,请编辑

    文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
    关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
    若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

    此页面有帮助吗?只是浏览 [ 去社区提问 ]