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

目录:

1. 环境类检测项编辑

风险类型问题
解决方案
阻塞项磁盘空间检测小于1G检测到当前FineBI安装目录磁盘剩余空间不足1G，升级需要保证安装目录下剩余空间大于1G，可以通过清理日志等无效文件或扩容磁盘等操作来保证安装目录有充足的磁盘空间
阻塞项外接数据库权限缺失检测到系统使用外接数据库且当前用户无外接数据库 DDL 权限，建议联系数据库运维人员修改当前外接数据库用户的 DDL 权限，然后再进行升级，无需重启。
阻塞项外接数据库编码有误检测到系统使用外接数据库且编码非要求的编码，MySQL 数据库编码要求为编码为 utf-8，需切换为内置数据库之后重新建立编码并配置外接数据库。

MySQL 参数 max_allowed_packet 过小

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

方案一：

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

方案二：

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

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


警告项系统曾发生升级回退不规范检测到当前系统曾经发生过升级回退的操作且未按照要求回退，此操作有可能会导致配置库中产生脏数据从而影响升级后的功能使用，建议先搭建测试环境在进行升级，验证使用之后在进行升级。

2. 配置类检测项编辑

风险类型问题解决方案
阻塞项JDK 版本过旧检测到 JDK 版本低于 1.8.0.102 ，旧版本 JDK 存在漏洞，升级后会存在启动崩溃的问题，需要更换为 1.8.0.102 以后版本的 JDK 再进行升级。 
警告项无法解析JDK版本格式通过代码无法解析当前使用的 JDK 版本，请验证当前 JDK 版本是否高于 1.8.0.102，旧版本 JDK 存在漏洞，升级后会存在启动崩溃的问题，需要更换为 1.8.0.102 以后版本的 JDK 再进行升级。 
警告项未检测到当天备份文件

检测到当前系统中近一天内无备份文件，建议备份后再进行升级。

3. 驱动文件检测项编辑

风险类型
问题解决方案
阻塞项hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR安装驱动隔离插件检测到系统使用了 hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR 等大数据平台，其使用的驱动容易和 BI 的代码产生冲突，强烈建议配置驱动隔离以保证系统的稳定运行，详细配置方式请参见：驱动隔离插件。
警告项配置数据库版本与驱动不匹配检测到当前系统使用的外接数据库为 oracle11g 之后的版本，建议将驱动更换为 ojdbc8 再进行升级。

4. lib 文件检测项编辑

风险类型
问题解决方案
阻塞项lib 目录下存在无效 zip 文件检测到 lib 文件中存在 zip 文件，此类型文件容易导致运行不稳定，建议删除或移动到%FineBI%/webroot/backup目录之后在进行升级。
阻塞项lib 目录下存在无效 jar 文件检测到lib文件中无效jar文件，此类型文件容易导致运行不稳定，建议您删除或移动到%FineBI%/webroot/backup目录之后在进行升级。
阻塞项lib 目录下 BI 相关 jar 存在重名文件检测到lib文件中以 fine 开头的 BI 的 jar 文件存在重名，此类型文件容易导致运行不稳定，建议其中之一删除或移动到%FineBI%/webroot/backup目录之后在进行升级。
阻塞项lib目录下BI相关 jar 存在冲突驱动文件检测到lib文件中存在 hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR 等大数据平台的驱动，该文件容易和BI的代码产生冲突，建议删除驱动之后在进行升级。
警告项lib目录下非BI相关 jar 存在重名文件检测到lib文件中存在 hive、phoenix、spark、impala、TRANSWARP 、INCEPTOR 等大数据平台的驱动，该文件有可能会影响 BI 的某些功能使用，比如数据连接，建议将其多余文件进行删除。

5. 插件检测项编辑

风险类型问题解决方案
警告项旧版本「权限&登录集成」插件需升级检测到使用了「权限&登录集成」插件，该插件需要随版本进行升级，如不升级可能影响到登陆功能的使用，可以联系技术支持获取新版本的文件进行替换并进行升级。
警告项旧版本多LDAP插件需升级检测到插件管理中存在 「多域LDAP认证 」 插件，该插件新版本功能逻辑发生变更，需手动进行调整，详见：多域LDAP认证
警告项定制开发插件适配确认检测到插件管理中存在二开插件，建议联系技术支持确认新版本插件的是否兼容，有可能会影响到新版本二开功能的使用。