1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 | JAR包日期 | 功能变更 |
|---|---|---|---|
| 10.0 & 11.0 | 4.1 | 2020-08-04 及以后 | - |
| 4.2 | 新增检测是否外接数据库 | ||
| 4.3 | 新增自动备份状态检测 | ||
| 4.4 | 新增信息项检测 |
1.2 应用场景
本插件主要用于产品升级前检测工程环境是否符合升级要求，以及是否存在升级风险项，获取升级所需要的重要信息，避免升级时出现问题。
10-11 跨大版本升级和小版本升级均适用。
2. 插件介绍
2.1 插件安装
点击下载插件：FR＆BI 升级工具
10.0服务器安装插件方法请参见：服务器插件管理
2.2 操作方法
1）完成插件安装后进入数据决策系统，可以发现左侧目录处出现「升级检测」，如下图所示：
2）选择「升级检测>升级注意事项」，仔细阅读「进行系统备份」、「升级后重启」两部分内容，并根据注意事项中的内容进行系统备份，完成后即可勾选「已经阅读完上述注意事项」，进行下一步，如下图所示：
3）点击下一步，即将开始为您自动检测，检测完成后将在界面上显示升级检测结果，可以根据检测内容和导出的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 文件，标记为警告项 | 检测到有自定义样式或是自定义类，有失效的风险，若失效则升级之后需要重新适配 |
| 自动备份状态检测 | 检测 24h 内是否存在配置的备份文件 | 检查是否有平台备份文件，若检测到当前系统中平台配置最近 24h 内无备份文件将会出现提示：检测到当前系统中平台配置最近 24h 内无备份文件，建议手动备份，需到「管理系统>智能运维>备份还原>平台配置」中选中手动备份，确认是否能备份成功，若备份失败需联系技术人员先解决备份问题。 |
| 部署方式 | 检测已有的工程的部署方式 | - |
| 操作系统 | 检测当前服务器所用操作系统及其版本 | - |
| FineReport 是否与 FineBI 集成 | 检测是否是 FineReport 与 FineBI 的集成 | - |
| 是否有正式授权 | - | - |
| 开发模板数量 | 检测 reportlet 文件夹下除内置模板外的模板数量 | - |
2.4 检测完成
完成检测后，出现提示：升级检查完成，请参考升级指南进行升级：https://help.fanruan.com/finereport/doc-view-4560.html ，再继续进行版本升级即可。
3. 常见问题
3.1 安装插件之后乱码或是出现英文
问题现象：
解决方案：刷新浏览器，或是清理浏览器缓存，也可以换浏览器访问。
