反馈已提交

网络繁忙

您好,只有最新版本的6.X支持在线编辑修改,如果想创建/编辑文档,请移步到 *最新版本*

5.1.1-5.1.5版本升级准备工作

  • 文档创建者:April陶
  • 历史版本:22
  • 最近更新:April陶 于 2023-04-28
  • 1. 概述

    1.1 版本

    FineBI 版本
    功能变动
    5.1-
    5.1.13升级时支持自动备份外接数据库

    1.2 适用版本

    适用于 5.1.1 升级到 5.1.2、5.1.3、5.1.5 版本在升级前进行准备工作。

    对应的升级文档参见:5.1.1-5.1.5升级指南

    升级版本确认及每个版本对应的文档索引参见:FineBI 版本说明

    2. 确定系统当前版本

    5.1.5 之前的版本升级则按照流程进行操作。

    3. 系统风险检测

    历史版本升级会有一些不兼容的问题。因此,升级前建议调整风险场景,降低升级风险。

    前往 【服务平台>在线支持】联系帆软技术支持为您评估升级风险。

    4. 修改系统风险项

    4.1 直连与抽取双引擎独立说明

    关于 FineBI 5.1.5 版本直连与抽取双引擎独立说明请参见文档:直连与抽数独立说明

    4.2 修改风险项

    风险项及修改方式如下表所示:

    风险类别
    风险点导致结果
    修改方式
    跨数据源使用直连 spider 表混用

    当前的使用方式会导致进行大量内存计算,严重拖累系统性能,还会增加内存溢出导致宕机的风险

    自 BI 5.1.5 版本(jar:2020-08-04)开始,将对直连模式和抽取模式进行拆分,不再支持抽取与直连模式的表配置关联关系,并且直连模式将不再支持跨库关联

    如果这些数据表来自不同的数据源(数据库),直连模式下将无法再关联使用

    「转为抽取」方式 1 :升级前将这些数据表转为抽取模式

    「需要保留实时性」方式 2 :升级过程中将会自动断开之间的关联关系,保持数据表可单独使用

    存在异构数据源关联
    直连自助数据集-来源表来自不同数据源
    基础表直连使用了自循环列当前的使用方式会导致进行大量内存计算,严重拖累系统性能,还会增加内存溢出导致宕机的风险

    自 BI 5.1.5 版本(jar:2020-08-04)开始,直连模式(实时化)的数据表,将不再支持该功能

    升级过程中将自动调整为抽取模式;或者升级前将该数据表转为抽取。
    直连使用了行列转化

    「转为抽取」方式 1 :升级前将这些数据表转为抽取模式

    「需要保留实时性」方式 2 :

    如果该表为 Excel 数据集,将无法保留实时性效果,升级会自动转为抽取模式。

    如果该表为 SQL 数据集,升级前将需改变的字段类型的通过修改 SQL 的方式调整 SQL 数据集

    如果该表为 DB 数据集。先使用「BI清理工具」将 DB 数据集转制为 SQL 数据集,再参考上述操作进行修改

    直连使用了字段类型改变
    自助数据集直连自助数据集排序

    当前的使用方式会导致进行大量内存计算,严重拖累系统性能,还会增加内存溢出导致宕机的风险

    自BI5.1.5版本(jar:2020-08-04)开始,直连模式(实时化)的数据表,将不再支持该功能

    升级过程中将自动调整为抽取模式;或者升级前将该数据表转为抽取
    直连自助数据集日期过滤前 N 个/后 N 个
    直连自助数据集数值过滤前 N 个/后 N 个
    直连自助数据集-数值过滤-大/小于等于平均值
    直连自助数据集-数值汇总-同期环期/同比环比
    直连自助数据集-文本汇总-字符串拼接
    自助数据集自定义分组使用了复制到分组

    该功能导致底层结构会导致严重性能问题,BI 5.1.5 版本(jar:2020-08-04),暂时不再支持该功能

    BI 5.1.6 版本(jar:2020-09-30),该功能从「分组汇总步骤」调整至「新增列步骤」,并优化了之前的性能问题

    升级完成后,需要重新操作在「自助数据集-新增列」中添加需要复制的分组;并调整相应的仪表板

    仪表板功能模版使用了直连不支持的日期过滤

    当前的使用方式会导致进行大量内存计算,严重拖累系统性能,还会增加内存溢出导致宕机的风险

    自BI5.1.5版本(jar:2020-08-04)开始,基于直连模式(实时化)数据表制作的组件或仪表板,将不再支持某些特定的日期过滤方式

    不再支持的特定的过滤方式如下:「日期字段」设置「包含/不包含、开头是/结尾是、开头不是/结尾不是」

    「转为抽取」方式1:升级前将对应的数据表转为抽取模式

    「需要保留实时性」方式2:升级前将所使用的过滤条件删除,并通过其他条件进行替代,实现之前过滤要求

    权限自循环列表当登陆者信息表

    自 BI 5.1.5 版本(jar:2020-08-04)开始,将对直连模式和抽取模式进行拆分,不再支持抽取与直连模式的表配置关联关系,并且直连模式将不再支持跨库关联

    如果这些该关联路径上,存在跨越直连和抽取两种模式的权限配置;那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作

    权限失效情况如下:1、直连模式的数据表,权限设置时使用了抽取模式的表,进行权限配置。2、抽取模式的数据表,权限设置时使用了直连模式的表,进行权限配置

    「转为抽取」方式1:升级前将这些数据表转为抽取模式

    「需要保留实时性」方式2:升级过程中会断开这类关联关系,权限也会随之失效;升级完成后根据需要重新配置
    配置权限的表的关联存在异数据源关联
    配置权限的表的关联存在混用数据集

    5. 阅读升级工作方式

    自 FIneBI 5.1.5 版本开始,将对直连模式和 spider 模式进行拆分,将不再支持直连模式表和抽取模式表建立关联关系,不再支持抽取和直连混用的自助数据集。对于现有的关联与混用数据表,升级过程中将自动检索现存的所有「混用模式数据表」;并找到这些数据表的「直连模式的父表」,通过复制SQL数据集的方式,对这些父表进行拷贝,复制其数据结果;来实现「抽取」与「直连」模式的分离调整。具体方式如图所示:

    image2020-6-2_21-34-48.png

    随着「抽取」与「直连」模式的分离,升级后「抽取」与「直连」模式数据表之间的关联关系也将随之丢失。如果这些该关联路径上,存在跨越直连和抽取两种模式的权限配置;那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作。

    权限失效情况如下:1、直连模式的数据表,权限设置时使用了抽取模式的表,进行权限配置。2、抽取模式的数据表,权限设置时使用了直连模式的表,进行权限配置。

    与此同时,直连模式的数据表将不再支持【自循环列】、【行列转换】、【更改字段类型】、【排序】、【自定义分组】、【跨数据源关联】等造成严重内存化问题的功能,使用了这些功能的数据表将被转至为抽取模式。

    如果使用了「抽取」与「直连」两种模式,升级完后系统将实现两种模式的数据准备模块完全独立。用户依旧可以使用统一的仪表板来添加不同模式的数据,并通过仪表板进行关联分析。

    6. 进行系统备份

    升级前请确认备份好 webroot 文件夹,如果配置了 外接数据库 请同时备份平台配置。系统升级过程都会顺利进行,为确保万无一失,做好系统备份可以在突发情况发生时,快速切换。

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

    注:版本升级不支持直接回退,请务必进行备份完成后再执行升级。

    6.1 内置数据库

    1)关闭 FineBI 。

    2)内置数据库的工程备份:若升级前工程没有配置过外接数据库,则需要备份好「webroot」文件夹,在 webroot 路径:%FineBI%\webapps\webroot下拷贝工程。如下图所示:

    2020-11-16_18-20-57.png

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

    6.2 外接数据库

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

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

    7. 升级前检查

    7.1 必做

    详情参见:升级前必须检查内容

    推荐5.1.1和5.1.2版本在升级前安装使用BI系统清理工具插件,详情参见:BI系统清理工具插件

    7.2 记录权限配置

    注:适用于 5.1.3 升级到 5.1.5。

    记录权限配置>业务包权限处「登录用户所在字段」的配置,升级后需要手动重新配置。

    7.3 修改国际化参数修改

    需要修改-Duser.language和-Duser.country为 zh 和 CN

    注:服务器系统语言和地区必须是 zh 和 CN。

    7.3.1 EXE 版本工程

    修改%FineBI_HOME%\bin目录下的文件 finebi.vmoptions 文件,修改内容如下:

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

    7.3.2 Tomcat 部署工程

    %Tomcat_HOME%\bin\catalina.sh 第一行添加:

    JAVA_OPTS = "$JAVA_OPTS -Duser.language=zh -Duser.country=CN"

    7.3.3 Weblogic 部署工程

    进入控制台,加上参数 -Duser.language=zh -Duser.country=CN

    7.4 基础表修改

    5.1.2 版本:基础表A做了编辑(修改了字段类型,取消勾选字段),数据库中修改基础表A的某个字段类型,更新基础表A,可以更新成功。
    升级到 5.1.5 版本:更新基础表 A,更新失败,需要重新编辑保存基础表 A 。

    7.5 其他问题

    1)5.1.3 升级到 5.1.5,如果原来在版本做过删除业务包的操作,可能会有无效行权限的脏数据,需要对该表中 tableID 为 null 的脏数据删除,否则可能导致迁移外置数据库到 oracle 失败。

    注:该问题已在5.1.2升级5.1.5工具进行处理。

    2)2020-09-01 的 5.1.5 版本新增功能 组件切换数据表;升级到 2020-09-01 及之后的版本,需要删除 BI切换表插件,才可以正常使用仪表板详细设置界面的切换表功能。

    3)2020-05-15 版本的 5.1.3 升级到 5.1.5,新建仪表板会出现报错 500 的现象,原因是模板访问 socket 插件无法使用备用方案,需要升级,此插件现在无法在线升级,需要删除后商城重新安装。

    8. 注意事项

    关于升级前的其他检查,可参见文档:5.1.x升级FAQ

    9. 升级

    准备工作结束后前往升级,参考文档:5.1.1-5.1.5升级指南

    集群升级,请参考文档:「集群」5.1.1-5.1.5升级指南

    附件列表


    主题: 安装与升级
    已经是第一篇
    已经是最后一篇
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

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

    在线QQ(将在2023.01.03关停):800049425

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭