5.1.1-5.1.2 升级指南

  • 文档创建者:Lily.Wang
  • 编辑次数:61次
  • 最近更新:Roxy 于 2020-07-02
  • 1. 概述

    为进一步完善之前版本在某些功能中的不足之处,FineBI 发布了 5.1.2 版本。若需要修复之前版本中存在的一些问题或需要使用新的功能,就需要升级到新版本。

    2. 升级步骤

    2.1 确认版本

    确认目前版本是 2019-07 发布的 5.1 版本。2019-07 之前发布的 5.1 版本需要先升级到 2019-07 版本,然后才能升级到 2020-01-15 版本。

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

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

    2.3 停止 BI 进程

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

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

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

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

    2.5 升级前检查

    2.5.1 检查数据挖掘功能

    若用户在升级前的 BI 中使用过数据挖掘功能,那么在升级之前需要把使用过数据挖掘相关功能的表删掉。

    检查路径%FineBI%\webapps\webroot\WEB-INF\lib下是否有 fine-bi-datamine-5.1.jar fine-bi-datamine-third-5.1.jar 两个包,如果有,就删掉。

    2.5.2 检查 FineDB 

    如果 BI 在升级至 5.1.2 前是从 4.1升级到 5.1 的,则需要修改 FineDB 。

    • 若 BI 配置了 外接数据库 ,则需要将fine_conf_entitycacheHeapcacheSeconds -1的值删掉。

    • 若 BI 未配置 外接数据库 ,则需要在 db.script 中将fine_conf_entitycacheHeapcacheSeconds -1的值删掉,可以使用文本编辑器打开 db.script ,查找cacheHeap相关内容,如下图所示:

      25.png

    2.5.3 检查驱动隔离插件

    若在升级之前使用过 5.1.1 版本驱动隔离插件 ,可点击管理系统>插件管理检查,若我的插件下有ClassLoader 拦截器字样的插件,则需要删除原插件,如下图所示:

    54.png

    在升级后根据 5.1.2 版本驱动隔离插件 重新安装。

    2.6 拷贝 JAR 包

    1)获取 5.1.2 版本的升级 JAR 包,拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中,替换原先的 JAR 包。

    2)安装版的 BI 需要用附件 lib 里的 JAR 包替换%FineBI%/lib下的三个 JAR 包,否则没有后台控制台显示。若是 BI 部署到了其他容器中,则不需要做这个步骤。如下图所示

    1573023805453802.png

    3)检查是否外接 Oracle 数据库,若外接了,则将路径%FineBI%\webapps\webroot\WEB-INF\lib下的驱动 ojdbc7 替换成 ojdbc14。

    下载链接:ojdbc14.jar

    2.7 升级后检查

    2.7.1 检查国际化参数

    1)更改国际化参数,否则报错信息会显示英文且不准确。Exe、Tomcat、Weblogic 的修改方式如下:

    • Exe

    选择%FineBI%/bin下 finebi.vmoptions 文件,如下图所示:

    image.png

    打开该文件,在该文件中增加:

    -Duser.language=zh
    -Duser.country=CN

    • Tomcat

    %tomcat%/bin 下 catalina.sh 文件第一行添加:JAVA_OPTS = "$JAVA_OPTS -Duser.language=zh -Duser.country=CN"

    22.png

    • Weblogic

    进入控制台,加上参数:

     -Duser.language=zh

     -Duser.country=CN

    20.png

    2)配置完成后,检查国际化参数是否生效。

    • Tomcat:

    执行 ps -aux | grep tomcat ,若出现如下内容,则表示参数生效:

    1589360569632674.png

    • weblogic:

    执行 ps -aux | grep weblogic,若出现 -Duser.language=zh -Duser.country=CN,则表示参数生效。

    如果没有上面的参数,说明参数被其他的配置覆盖,需要检查参数配置。

    3. 注意事项

    3.1 仪表板

    3.1.1 仪表板打不开

    升级后,若无法打开仪表板并一直显示加载中,可以清除浏览器缓存后重新打开 FineBI。(每种浏览器清除缓存方式不同,可以在网上搜索清除缓存方式)

    3.1.2 其他

    • 升级后分类轴在纵向时,默认设置为右对齐。

    • 升级后原仪表板的配色方案如果是非自动(例如:彩虹),那么升级后维度与颜色匹配关系仍然保留,只是顺序改变。

    • 5.1 饼图起始点位置为 0 度,5.1.2 版本饼图起点位置是 90 度。

    • 5.1 文本组件升级5.1.2 版本后,可显示区域变大,整体适应时,字体变大。

    3.2 自助数据集

    3.2.1 新增列字段升级后丢失

    • 自助数据集中若有两个新增列且名称一致,在升级后,会提示后添加的新增列字段丢失。因此需要删除后,重新添加对应的新增列。

    3.2.2 自助数据集标红

    自助数据集升级后不标红的表标红

    原因分析:自助数据集使用的是关联表,升级后标红且更新失败,重做一模一样的自助数据集正常,可 F12 打开控制台,进入自助数据集选字段的编辑界面,查看标红的自助数据集Network>page>headers>table>operators-数字-value下字段索引都应该是相同的表名,若不是一致的,则会标红,如下图所示:30.png

    解决方案:

    1)使用 使用第三方管理软件连接工程内置 HSQL 数据库 FineDB 连接内置数据库或者连接外接数据库,在fine_conf_entity表里面添加参数:SystemOptimizationConfig.needTreatRedMark,参数值为:true

    2)检查参数是否配置成功:设置 INFO/DEBUG 级别启动日志,如下图所示:

    438.png

    %FineBI%\logs 中可搜到:treat analysisTable redMark start,treat analysisTable redMark end

    3)重启后问题解决且需要将参数去掉。

    3.3 大数据展示数据量

    5.1.2 版本前的大数据展示没有限定展示的数据量,升级后,依据限定的数据量展示。

    3.3.1 雷达图

    分组数据小于 1k 不触发大数据模式;分组数据属于(1k,5k),触发大数据模式,展示实际分组数据;分组数据大于 5k , 触发大数据模式,限定分组数据 5k ;

    3.3.2 饼图、漏斗图、矩形块、力学气泡图、多层饼图

    小于等于 5k 分组数据,不触发大数据模式;大于5k分组数据触发大数据模式, 限定展示分组数据5k;特殊说明:多层饼图大数据模式下,分组数据在 5k+ ;

    3.3.3 热力地图

    限定展示分组数据 2w ;

    3.3.4 标准适应条件下

    小于等于 5k 分组数据,不触发大数据模式;大于 5k 分组数据触发大数据模式,不同环境展示数据量不同;系统 GCC 不满足要求,限定分组数据 10w;系统gcc满足要求,限定分组数据 30w ;

    若需要升级系统 GCC,详情参见: 图表大数据GCC升级 。

    3.3.5 宽度适应、高度适应、整体适应条件下

    小于等于 5k 分组数据,不触发大数据模式;大于 5k 分组数据,触发大数据模式,不同图  形,限定展示的分组数据不同:

    • 热力点,限定分组数据 5w ;

    • 漏斗图、仪表盘、填充地图(非地理坐标系)、文本、饼图、矩形块,限定分组数据 1w;

    • 点、柱形图、线、面积,限定分组数据 10w;

    3.4 权限

    • 在升级后,默认对所有用户都关闭公共链接的权限,如果要用再需由管理员开启。(超管账号不做权限限制,升级后正常使用)详情参见: 公共链接权限

    • 在升级后,默认关闭全局设置下的仪表板-分享控制。若要打开了分享控制,普通用户的分享权限需要由管理员重新配置。详情参见: 仪表板分享权限

    3.5 其他

    • 5.1.1 之前的 BI 版本如果有在目录管理<添加链接时无法添加公共链接的问题,且升级之后还需使用旧的内置 FineDB 数据库,升级之后需要手动修改 demo 数据库的字段长度,或者迁移数据库并使用 外接数据库 。

    4. 升级回退

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

    附件列表


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