升级风险项及修复方案列表- FineBI Help Document

Last update：September 23, 2022

1. 概述

使用「FR和BI升级检测」工具，进行 6.0 升级检测时，导出的风险项及修复方案介绍。

6.0升级前检测步骤详情参见：升级前检测

2. 风险项及修复方案

检测工具处理：是升级检测插件自动处理

	分类	阻塞等级	处理方式	检查内容	界面提示内容	Excel提示内容
1	配置	SUGGEST	检测工具处理	1）有配置外置库 2）WEB-INF/config/db.properties中hibernate.hbm2ddl.auto值是否设置为update	无需提示	检测到系统配置hibernate.hbm2ddl.auto不为update，修改该配置参数为update，否则升级过程中无法进行配置兼容升级
2	配置	WARN	手动处理	1）检测MySQL参数max_allowed_packet需配置小于1073741824，则标记为警告项 2）检测不到MySQL参数max_allowed_packet，则标记为警告项	WARN:配置外置库为MySQL且参数max_allowed_packet小于1073741824，影响配置兼容执行 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%';」语句查看是否修改成功。
3	配置	SUGGEST	检测工具处理	UpdatePushConfig.open”，检测值是否为false，标记为提示项	导出文件提示
4	配置	BLOCK	手动处理	获取spider_local_root_path对应的路径，检查对应路径下是否可以创建文件	检测到XXXX路径下无文件创建权限，该路径为数据更新路径且必须有文件读写权限	检测到XXXX路径下无文件创建权限，该路径为数据更新路径且必须有文件读写权限，请使用chmod路径给该路径赋权，命令格式如下 chmod -R 777 xxx路径
5	配置	BLOCK/ WARN	手动处理	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版本更新后引入加密套件，可能导致数据连接连接不上，需要按照如下文档进行完善：JDK 升级及注意事项
6	配置	WARN	手动处理	检测 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配置是否仍在使用，如已停止使用登陆超级管理员，在智能运维→ 集群配置中,将状态服务器改为关闭状态
7	配置	WARN	手动处理	检测是否有当天的备份文件	WARN : 检测到系统近一天内无成功备份，请确认系统配置有备份	检测到当前系统中近一天内无备份文件，建议您备份后再进行升级：备份还原
8	驱动	WARN	手动处理	检测外置库为oracle11g及以上版本且lib目录下无ojdbc8	WARN : 检测到外置库为oracle11g及以上的版本，建议您使用匹配的驱动ojdbc8	检测到当前系统使用的外置库为oracle11g及之后的版本，建议您将驱动更换为ojdbc8再进行升级，需要将ojdbc14.jar文件更换为ojdbc8.jar和orai18n.jar两个jar文件
9	驱动	BLOCK	手动处理	hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR安装驱动隔离插件	BLOCK：驱动冲突阻塞	检测到系统使用了hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大数据平台，其使用的驱动容易和BI的代码产生冲突，强烈建议您配置驱动隔离以保证系统的稳定运行，详细配置方式：5.1.2 及之后版本驱动隔离插件
10	lib异常文件	BLOCK	手动处理	commons等jar，检测后提示删除	BLOCK：lib异常文件冲突阻塞	检测到该文件容易和BI的代码产生冲突，需要您删除之后重启BI，然后进行升级
11	lib异常文件	BLOCK	手动处理	lib下文件夹、zip文件、重名文件，检测后提示删除	BLOCK：lib异常文件冲突阻塞	检测到lib文件中存在文件夹、zip文件、重名文件，此类型文件极容易导致BI运行不稳定，需要您删除之后重启BI，然后进行升级。
12	lib异常文件	WARN	手动处理	lib下文件夹下非txt和jar文件认为是非法文件，检测后提示删除	WARNING：lib异常文件警告，建议删除	检测到lib文件中存在非jar和非txt的文件，可能对工程产生影响，请删除后在升级。
13	lib异常文件	BLOCK	手动处理	hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR、hbase、maxcomputer、kylin、驱动包 hive： geronimo-jaspi、hadoop-common、hive-jdbc、xercesImpl spark： hadoop-core、hive-jdbc maxcomputer slf4j-log4j、odps-jdbc TRANSWARP -INCEPTOR TRANSWARP 、INCEPTOR hbase、phoenix phoenix impala impala kylin kylin	BLOCK：lib异常文件冲突阻塞	检测到lib文件中存在hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR等大数据平台的驱动，该文件容易和BI的代码产生冲突，需要您删除之后重启BI，然后进行升级
14	lib异常文件	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，然后进行升级
15	插件	WARN	手动处理	检测插件名存在JSD、SLN等二开插件	WARN：检测到插件管理中存在二开插件，建议您联系技术支持确认新版本插件的是否兼容	检测到插件管理中存在二开插件，建议您联系技术支持确认新版本插件的是否兼容
16	插件	WARN	手动处理	插件检测插件名称存在压缩文件名fr-plugin-platform-bridge，压缩文件名com.tptj.plugin.hg.platform.bridge；安装文件名plugin-com.tptj.plugin.hg.platform.bridge 明确需升级插件	WARN：检测到插件管理中存在单点插件，建议您联系技术支持获取新版本插件	检测到插件管理中存在单点登录插件，建议您联系技术支持确认新版本插件的是否兼容
17	插件	SUGGEST	检测工具处理	删除插件plugin-com.fr.plugin.decision.data.check，压缩文件plugin-com.fr.plugin.decision.data.check	导出文件提示	检测到插件管理中存在无效插件插件，该插件影响升级执行，会在升级过程中自动删除
18	插件	SUGGEST	检测工具处理	删除插件数据集切换表bi-plugin-table-switcher-1.0.2-513.zip	导出文件提示	检测到插件管理中存在无效插件插件，该插件影响升级执行，会在升级过程中自动删除
19	插件	SUGGEST	检测工具处理	删除插件仪表板默认选择表格fr-plugin-default-widget-type-1.0.0.zip	导出文件提示	检测到插件管理中存在仪表板默认选择表格插件，新版本已包含该功能，会在升级过程中自动删除
20	插件	SUGGEST	检测工具处理	删除com.fr.plugin.platform.safelogin	导出文件提示	检测到插件管理中存在9.0版本插件，当前系统为10.0版本，该插件对系统稳定性产生隐患，已自动删除
21	插件	WARN	手动处理	检测插件名称是否存在 name : 多ldap登陆 id不为： com.fr.plugin.decision.multi.ldap.passport 提示升级后需要重新配置	导出文件提示	检测到插件管理中存在 “ 多域LDAP认证 ” 插件，该插件新版本功能逻辑发生变更，需手动进行调整，详见帮助文档：多域LDAP认证
22	插件	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版本，该插件对系统稳定性产生隐患，已自动删除
23	插件	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	导出文件提示	检测到插件管理中存在旧版本工具插件，该插件对系统稳定性产生隐患，已自动删除
24	插件	WARN	手动处理	检测当前环境是否能连接到插件商城，提示升级后插件需要升级	WARN :如果可以连接提示升级后登陆插件管理页面升级对应插件升级项如果不可以连接提示打开插件商城https://market.fanruan.com/查看已安装插件是否有新版本更新	（有外网）升级后请登陆系统，打开插件管理页面升级提示需要升级的插件，当前已经安装XXX个插件，如不更新对应的插件将导致部分功能异常。或（无外网）检测到当前环境无法连接到插件商城，请打开插件商城查看已安装插件是否有新版本更新，并下载对应的插件进行本地更新，当前已经安装XXX个插件，如不更新对应的插件将导致部分功能异常。
25	插件	WARN	手动处理	插件依赖丢失可能导致的插件异常（如果该项可以实现13、14、22可以无需提示）
26	插件	suggest	检测工具处理	删除插件文件名：plugin-com.fr.plugin.operation ID：com.fr.plugin.operation
27	插件	BLOCK	手动处理	检测BI热备插件启用 plugin-bi-hot-backup	BLOCK：热备集群不支持升级	检测到插件管理中启用BI热备插件，当前升级工具暂不支持热备环境升级
28	插件	WARN	升级工具处理	检测spider数据集插件 plugin-report-spider-dataset	导出文件提示	检测到插件管理中存在Spider数据集，6.0暂不支持此功能，会在升级过程中禁用
29	插件	SUGGEST	升级工具处理	删除驱动隔离插件 plugin-decision-driver-loader https://git.fanruan.com/fanruan/demo-driver-loader/src/master	导出文件提示	检测到插件管理中存在 ”XXXX“ 插件，新版本已包含该功能，会在升级过程中自动删除
30	插件	SUGGEST	升级工具处理	删除前端区分处理分析表插件 bi-plugin-classify-table	导出文件提示	检测到插件管理中存在 ”XXXX“ 插件，新版本不再区分处理分析表，会在升级过程中自动删除
31	插件	SUGGEST	升级工具处理	删除BI模板访问socket插件 plugin-bi-websocket-visit	导出文件提示	检测到插件管理中存在 ”XXXX“ 插件，新版本已包含该功能，会在升级过程中自动删除
	插件	SUGGEST	升级工具处理	HTTPS_SameSite_跨域 com.fr.plugin.decision.cookie.check	导出文件提示	检测到插件管理中存在 ”XXXX“ 插件，新版本已包含该功能，会在升级过程中自动删除
	插件	SUGGEST	升级工具处理	数据集中SQL可全屏 com.fr.solution.plugin.better.sql.editor	导出文件提示	检测到插件管理中存在 ”XXXX“ 插件，新版本已包含该功能，会在升级过程中自动删除
	插件	SUGGEST	升级工具处理	新手引导 com.fr.plugin.user.guide	导出文件提示	新版本已内置
32	插件	SUGGEST	升级工具处理	BI字段分组插件 com.finebi.plugin.fieldgroup	导出文件提示	不再支持此插件
33	插件	SUGGEST	手动处理	删除BI模板屏幕自适应 plugin-bi-screen-adaptive 升级后自动更新为BI模板屏幕自适应plus：plugin-bi-show-adaptive	导出文件提示	检测到插件管理中存在 ”XXXX“ 插件，新版本已不支持该插件，会在升级过程中自动删除；如需使用，请于插件商城下载“BI模板屏幕自适应plus”插件
34	数据	WARN	手动处理	检测自定义函数class的规范性	WARN：自定义函数xxx无法序列化	检测到系统中存在自定义函数xxxxx，该函数编写不规范导致无法序列化，请重新修改适配。
35	数据	WARN	手动处理	检测到用户自助数据集下Excel表使用了自循环列与行列转换	WARN：用户自助数据集下的Excel表升级后不再支持自循环列与行列转换步骤	检测到XX用户自助数据集的xxExcel表存在行列转换/自循环列步骤，建议移动到公共数据
36	数据	WARN	手动处理	检测复合过滤组件参数使用了过滤组件	WARN：复合过滤组件不再支持引用控件参数的用法	检测到复合过滤组件x使用到了过滤组件的参数用法，建议调整不含过滤组件参数的过滤方法
37	环境	BLOCK/ WARN	手动处理	磁盘空间检测<1g，标记为阻塞项检测不到磁盘空间，标记为警告项		检测到当前磁盘剩余空间不足1G，请确保磁盘空间大于1G再进行升级，您可以先清理磁盘空间然后进行升级”
38	环境	WARN	手动处理	是否发生升级回退		检测到您系统曾经发生升级未按照文档回退配置内容，该操作可能产生脏数据，强烈建议您先测试环境进行升级验证
39	环境	BLOCK/ WARN	手动处理	检测外置库DDL权限缺失，标记为阻塞项		检测到您系统使用外置库且当前用户无外置库表的增删改查（DDL）权限，建议您联系数据库运维人员修改对应权限后再进行升级
40	环境	BLOCK/ WARN	手动处理	检测外置库编码 mysql编码不为utf8或utf8mb4，标记阻塞 SQL server编码不为为Chinese_PRC_CS_AS，如果是Chinese_PRC_CI_AS标记为warn，其他的为BLOCK		检测外置库编码不为要求的编码
41	环境	WARN	手动处理	检测当前环境是否为集群环境，如果是提示更新nginx	WARN :检测到当前环境为集群环境，升级后请参考帮助文档：版本升级Nginx配置指导更新nginx转发配置	WARN :检测到当前环境为集群环境，升级后请参考帮助文档：版本升级Nginx配置指导更新nginx转发配置
42	环境	SUGGEST	手动处理			升级后需清理浏览器缓存
43	环境	BLOCK	手动处理	检测运行环境是否存在msvcr120.dll		msvcr120.dll运行库不存在，需要安装x64版本的 Visual Studio 2010 (VC++ 10.0) 之后再进行升级, 可参考微软帮助文档：点击进入

Helpful
Not helpful
Only read

中文（简体）中文（繁體）日本語

English

升级风险项及修复方案列表

1. 概述

2. 风险项及修复方案

附件列表