1. 概述编辑
1.1 版本
报表服务器版本 | 插件版本 | JAR包日期 |
---|---|---|
10.0 & 11.0 | 4.1 | 2020-08-04 及以后 |
1.2 应用场景
本插件主要用于产品升级前检测工程环境是否符合升级要求,以及存在是升级风险项,获取升级所需要的重要信息,避免升级时出现问题。10-11 跨大版本升级和小版本升级均试用。
2. 插件介绍编辑
2.1 插件安装
点击下载插件:FR&BI 升级工具
设计器插件安装方法请参见:设计器插件管理
服务器安装插件方法请参见:服务器插件管理
2.2 操作方法
1)完成插件安装后进入数据决策系统,可以发现左侧目录处出现「升级检测」,如下图所示:
2)选择「升级检测>升级注意事项」,仔细阅读「进行系统备份」、「升级后重启」两部分内容,并根据注意事项中的内容进行系统备份,完成后即可勾选「已经阅读完上述注意事项」,进行下一步,如下图所示:
3)点击「下一步」将会出现提示框,无论是否备份工程,此步骤点击确认即可,目的在提醒升级前需要备份。
4)可以根据检测内容和导出的excel自行阅读检测,或是发送给技术人员协助评估。
2.3 检测内容说明
点击「确定」后将进行升级检测,升级检测级别定义如下:
阻塞项:影响升级执行,如不调整无法进行下一步升级
警告项:不影响正常升级但是影响升级后功能使用,需升级后手动处理
提示项:系统自动处理的隐患以及建议您升级后根据配置进行检查项
注:阻塞项、警告项均会在界面上出现提示,提示项需要导出 Excel 查看。
检测内容及提示内容如下表所示:
检测项 | 提示信息 | |
---|---|---|
检测磁盘空间 | 磁盘空间检测小于 3G,标记为阻塞项; 检测不到磁盘空间,标记为警告项; | 检测到当前磁盘剩余空间不足 3G,请确保磁盘空间大于 3G 再进行升级,您可以先清理磁盘空间然后进行升级 |
检测是否是外接库 | 检测是否外接库,内置库说明为内置库,外接库做出提示,标记为建议项 | 检测到是外界库,升级工具处理升级之后,平台会转为默认的内置finedb 模式。升级之后需要重新新建新的数据库做外接库迁移 |
检测外置库权限 | 检测外置库 DDL 权限缺失,标记为阻塞项 | 外接库 DDL 权限缺失,需要开放权限 |
检测外置库编码 | mysql编码不为 utf8 或 utf8mb4,标记为阻塞项; SQL server编码不为Chinese_PRC_CS_AS,如果是Chinese_PRC_CI_AS标记为警告项,其他的为阻塞项; | 外置库编码不是要求的编码 |
检测 JDK | JDK 版本为 oracle 的 1.8.0.102,需先升级 JDK,标记为阻塞项; 检测不到JDK版本信息,标记为警告项; | JDK版本低于 1.8.0.102,升级后会因为 JDK 漏洞导致启动异常,请您先升级 JDK 版本 |
检测 lib 文件夹 | 检测是否存在 fr-xxxx-8.0、fr-xxxx-9.0,或是以 .bak 结尾的 JAR 包,标记为阻塞项 | lib 异常文件冲突阻塞,需删除多余 JAR 包 |
检测端口 | 升级过程会占用 20216 和 20217 端口,检测这两个端口是否被占用,标记为阻塞项 | 检测到端口被占用,20216 和 20217 端口被占用会导致升级失败,需保证端口不被占用 |
web 容器检测 | 检测 web 容器版本,低于要求的版本可参考:部署环境准备,标记为阻塞项 | 检测到web容器版本不适配,需升级版本详见:部署环境准备 |
插件检测 | 1)检测插件是否存在二开定制:插件名存在 JSD、SLN 等二开插件,标记为警告项 2)检测客户是否有11版本尚未适配的插件,标记为警告项(11版本适配可以检测的,但是如果有的插件没有按规则适配无法检测) 3)检测客户网络环境,网络不通时,标记为警告项 | 1)检测到插件管理中存在二开插件,建议您联系技术支持确认新版本插件的是否兼容 2)检测到 11 版本暂时未适配插件,插件可能会出现升级后无法使用的情况 3)检测到网络链路不通,无法进行插件适配性检测,可能会出现升级后插件未适配无法使用 |
自定义资源检测 | 检测是否引入自定义 css 文件和 class 文件,标记为警告项 | 检测到有自定义样式或是自定义类,有失效的风险,若失效则升级之后需要重新适配 |
2.4 检测完成
完成检测后,可以参考页面文档:升级检查完成,请参考升级指南进行升级:https://help.fanruan.com/finereport/doc-view-4560.html 进行版本升级。
3. 常见问题编辑
3.1 安装插件之后乱码或是出现英文
现象:
解决方案:刷新浏览器,或是清理浏览器缓存,也可以换浏览器访问。