历史版本13 :升级风险项及处理方法 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 环境类检测项编辑

检测级别
检测内容处理方案BI界面提示导出 Excel 提示

BLOCK/

WARNING


磁盘空间检测<1g,标记为阻塞项

检测不到磁盘空间,标记为警告项

提示处理方案,自行处理检测到当前磁盘剩余空间不足1G,请确保磁盘空间大于1G再进行升级,您可以先清理磁盘空间然后进行升级”检测到当前磁盘剩余空间不足1G,请确保磁盘空间大于1G再进行升级,您可以先清理磁盘空间然后进行升级”
WARNING是否发生升级回退建议先在测试环境进行升级-检测到您系统曾经发生升级未按照文档回退配置内容,该操作可能产生脏数据,强烈建议您先测试环境进行升级验证

BLOCK/

WARNING

检测外置库DDL权限缺失,标记为阻塞项提示处理方案,自行处理-检测到您系统使用外置库且当前用户无外置库表的增删改查(DDL)权限,建议您联系数据库运维人员修改对应权限后再进行升级

BLOCK/

WARNING

检测外置库编码

mysql编码不为utf8或utf8mb4,标记阻塞

SQL server编码不为为Chinese_PRC_CS_AS,如果是

Chinese_PRC_CI_AS标记为warn,其他的为BLOCK



提示处理方案,自行处理-

检测外置库编码不为要求的编码

WARNING检测当前环境是否为集群环境,如果是提示更新nginx提示处理方案,客自行处理WARN :检测到当前环境为集群环境,升级后请参考帮助文档更新nginx转发配置WARN :检测到当前环境为集群环境,升级后请参考帮助文档更新nginx转发配置
SUGGEST---升级后需清理浏览器缓存
BLOCK检测运行环境是否存在msvcr120.dll提示处理方案,自行处理-

msvcr120.dll运行库不存在,需要安装x64版本的 Visual Studio 2010 (VC++ 10.0) 之后再进行升级, 可参考微软帮助文档:https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-160。


2. 配置类检测项编辑

检测级别检测内容
处理方案BI 界面提示导出 Excel 提示


WARNING

1)检测MySQL参数max_allowed_packet需配置小于1073741824,则标记为警告项

2)检测不到MySQL参数max_allowed_packet,则标记为警告项


提示处理方案,需要您自行处理


1)WARN:配置外置库为MySQL且参数max_allowed_packet小于1073741824,影响配置兼容执行

2)WARN : 当前外置库连接用户无权限查询MySQL的max_allowed_packet参数,要求参数值>=1073741824,请您自行查询

检测到外置库为MySQL,且参数max_allowed_packet<1073741824,升级过程需要对配置进行兼容调整,参数过小会导致配置写入数据库失败,为保证升级顺利进行,请您优先调整max_allowed_packet参数,调整方式如下

方案一:

MySQL 安装目录下的「my.ini」文件中的[mysqld] 字段中的「max_allowed_packet = 1M」修改为 1024M ,重启 MySQL 即可。

方案二:

1)使用「set global max_allowed_packet = 1073741824;」 语句将「max_allowed_packet」的值设置为 1024M,无需重启。

2)使用「show VARIABLES like '%max_allowed_packet%';」 语句查看是否修改成功。

SUGGESTUpdatePushConfig.open”,检测值是否为false,标记为提示项

产品自动处理



FineDB中配置UpdatePushConfig.open为true,自动更改为false
BLOCK获取spider_local_root_path对应的路径,检查对应路径下是否可以创建文件提示处理方案您可自行处理检测到XXXX路径下无文件创建权限,该路径为数据更新路径且必须有文件读写权限检测到XXXX路径下无文件创建权限,该路径为数据更新路径且必须有文件读写权限,请使用chmod路径给该路径赋权 ,命令格式如下 chmod -R 777 xxx路径

BLOCK/

WARNING

1)jdk版本为oracle的1.8.0.102,需先升级JDK,标记为阻塞项

2)检测不到JDK版本信息,标记为警告项

提示处理方案,您可自行处理

BLOCK: JDK版本低于1.8.0.102,升级后会因为JDK漏洞导致启动异常,请您先升级JDK版本在进行BI升级

WARN : 当前无法获取JDK版本,请您先确认JDK版本大于1.8.0.102

检测到jdk 版本低于1.8.0.102 ,旧版本JDK存在漏洞,升级后会存在启动崩溃的现象,需要更换为1.8.0.102以后版本的 jdk 再进行升级。 

JDK版本更新后引入加密套件,可能导致数据连接连接不上,需要按照如下文档进行完善
src="https://help.fanruan.com/finebi6.0/doc-view-1617.html

WARNING

检测  FineClusterConfig.params.cluster为false

SystemOptimizationConfig.biClusterMasterNodeHostName  非空

hotBackConf.master 非空 

SystemOptimizationConfig.ClientMasterId 非空

hotBackConf.slave 非空


StateServerConfig.type != standone

StateServerConfig.clusterMode != false


提示处理方案,您可自行处理

WARN : 检测当前为单机环境但是残留集群相关配置,需删除残留参数

检测当前为单机环境但是残留集群相关配置,需删除残留参数,以下热备参数需删除,需连接配置库中将fine_conf_entity表中对应参数进行修改

非空则提示需删除ID为:SystemOptimizationConfig.biClusterMasterNodeHostName  

非空则提示需删除ID为:hotBackConf.master  

非空则提示需删除ID为:SystemOptimizationConfig.ClientMasterId   

非空则提示需删除ID为:hotBackConf.slave  

以下为redis配置参数,请确认redis配置是否仍在使用,如已停止使用登陆超级管理员,在智能运维→ 集群配置中,将状态服务器改为关闭状态

WARNING检测是否有当天的备份文件提示处理方案,您可自行处理WARN : 检测到系统近一天内无成功备份,请确认系统配置有备份检测到当前系统中近一天内无备份文件,建议您备份后再进行升级

3. 驱动文件检测项编辑

检测级别
检测内容处理方案BI 界面提示导出 Excel 提示
WARNNING检测外置库为oracle11g及以上版本且lib目录下无ojdbc8提示处理方案,您可自行处理WARN : 检测到外置库为oracle11g及以上的版本,建议您使用匹配的驱动ojdbc8检测到当前系统使用的外置库为oracle11g及之后的版本,建议您将驱动更换为ojdbc8再进行升级,需要将ojdbc14.jar文件更换为ojdbc8.jar和orai18n.jar两个jar文件
BLOCKhive、phoenix、spark、impala、TRANSWARP 、INCEPTOR安装驱动隔离插件

提示处理方案,您可自行处理

BLOCK:驱动冲突阻塞检测到系统使用了hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大数据平台,其使用的驱动容易和BI的代码产生冲突,强烈建议您配置驱动隔离以保证系统的稳定运行,详情参见:驱动隔离插件

4. lib 文件检测项编辑

检测级别检测内容处理方案BI 界面提示导出 Excel 提示
BLOCKcommons等jar,检测后提示删除提示处理方案,自行处理BLOCK:lib异常文件冲突阻塞检测到该文件容易和BI的代码产生冲突,需要您删除之后重启BI,然后进行升级
BLOCKlib下文件夹、zip文件、重名文件,检测后提示删除提示处理方案,自行处理BLOCK:lib异常文件冲突阻塞检测到lib文件中存在文件夹、zip文件、重名文件,此类型文件极容易导致BI运行不稳定,需要您删除之后重启BI,然后进行升级。
WARNINGlib下文件夹下非txt和jar文件认为是非法文件,检测后提示删除提示处理方案,自行处理WARNING:lib异常文件警告,建议删除

检测到lib文件中存在非jar和非txt的文件,可能对工程产生影响,请删除后在升级。

BLOCK

hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR、hbase、maxcomputer、kylin、驱动包

提示处理方案,自行处理BLOCK:lib异常文件冲突阻塞检测到lib文件中存在hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大数据平台的驱动,该文件容易和BI的代码产生冲突,需要您删除之后重启BI,然后进行升级
BLOCK检测是否存在fr-xxxx-8.0、fr-xxxx-9.0、fr-xxxx-4.0、fr-xxxx-4.1、fr-slf4j-frlog4j提示处理方案,自行处理BLOCK:lib异常文件冲突阻塞检测到lib文件中存在8.0、9.0版本的jar文件,该文件容易和BI的代码产生冲突,需要您删除之后重启BI,然后进行升级

5. 插件检测项编辑

检测级别检测内容处理方案BI 界面提示导出 Excel 提示
WARNING检测插件名存在JSD、SLN等二开插件提示处理方案,自行处理WARN:检测到插件管理中存在二开插件,建议您联系技术支持确认新版本插件的是否兼容检测到插件管理中存在二开插件,建议您联系技术支持确认新版本插件的是否兼容
WARNING

插件检测插件名称存在

压缩文件名fr-plugin-platform-bridge,

压缩文件名com.tptj.plugin.hg.platform.bridge;安装文件名plugin-com.tptj.plugin.hg.platform.bridge

明确需升级插件

提示处理方案,自行处理WARN:检测到插件管理中存在单点插件,建议您联系技术支持获取新版本插件检测到插件管理中存在单点登录插件,建议您联系技术支持确认新版本插件的是否兼容
SUGGEST删除插件plugin-com.fr.plugin.decision.data.check,压缩文件plugin-com.fr.plugin.decision.data.check

自动处理


导出文件提示检测到插件管理中存在无效插件插件,该插件影响升级执行,会在升级过程中自动删除
SUGGEST删除插件数据集切换表插件

自动处理


导出文件提示检测到插件管理中存在无效插件插件,该插件影响升级执行,会在升级过程中自动删除
SUGGEST删除插件仪表板默认选择表格插件

自动处理


导出文件提示检测到插件管理中存在仪表板默认选择表格插件,新版本已包含该功能,会在升级过程中自动删除
SUGGEST删除com.fr.plugin.platform.safelogin

自动处理


导出文件提示检测到插件管理中存在9.0版本插件,当前系统为10.0版本,该插件对系统稳定性产生隐患,已自动删除
WARNING

检测插件名称是否存在

name :  多ldap登陆

id不为: com.fr.plugin.decision.multi.ldap.passport

提示升级后需要重新配置

提示处理方案,客户自行处理导出文件提示检测到插件管理中存在 “ 多域LDAP认证 ” 插件,该插件新版本功能逻辑发生变更,需手动进行调整,详见帮助文档src="https://help.fanruan.com/finebi6.0/doc-view-1188.html
SUGGEST

删除插件名称是否存在plugin-com.finebi.memory-1.0.5、plugin-com.finebi.memory-1.0.5

删除插件名称是否存在plugin-com.finebi.memory-1.0.6、plugin-com.finebi.memory-1.0.6

自动处理


导出文件提示检测到插件管理中存在旧版本内存管理插件,当前系统为10.0版本,该插件对系统稳定性产生隐患,已自动删除
SUGGEST

压缩文件名fr-plugin-bi-inspector id :com.finebi.plugin.bi.inspector 安装文件名:plugin-com.finebi.plugin.bi.inspector


压缩文件名fr-plugin-bi-cleaner id :com.finebi.plugin.bi.cleaner 安装文件名:plugin-com.finebi.plugin.bi.cleaner

自动处理


导出文件提示检测到插件管理中存在旧版本工具插件,该插件对系统稳定性产生隐患,已自动删除
WARNING检测当前环境是否能连接到插件商城,提示升级后插件需要升级提示处理方案,自行处理

WARN :如果可以连接提示升级后登陆插件管理页面升级对应插件升级项

如果不可以连接提示打开插件商城https://market.fanruan.com/查看已安装插件是否有新版本更新

(有外网)升级后请登陆系统,打开插件管理页面升级提示需要升级的插件,当前已经安装XXX个插件,如不更新对应的插件将导致部分功能异常。

(无外网)检测到当前环境无法连接到插件商城,请打开插件商城https://market.fanruan.com/查看已安装插件是否有新版本更新,并下载对应的插件进行本地更新,当前已经安装XXX个插件,如不更新对应的插件将导致部分功能异常。

WARNING插件依赖丢失可能导致的插件异常(如果该项可以实现13、14、22可以无需提示)提示处理方案,自行处理

SUGGEST

删除插件

文件名:plugin-com.fr.plugin.operation

ID:com.fr.plugin.operation

自动处理




WARNNING插件类资源丢失自行处理-

依赖存在丢失,请先删除插件,升级完毕后更新最新插件

依赖存在丢失,可能影响功能