1. 概述编辑
1.1 版本
| 报表服务器版本 | JAR包日期 |
|---|---|
| 10.0 | 2020-08-04 及以后 |
1.2 应用场景
本插件主要用于跨版本的升级前检测工程环境是否符合升级要求，以及存在是升级风险项，获取升级所需要的重要信息，避免升级时出现问题。
2. 插件介绍编辑
2.1 插件安装
点击下载插件：FR＆BI 升级工具
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
2.2 操作方法
1）完成插件安装后进入数据决策系统，可以发现左侧目录处出现「升级检测」，如下图所示：
2）选择「升级检测>升级注意事项」，仔细阅读「进行系统备份」、「升级后重启」两部分内容，并根据注意事项中的内容进行系统备份，完成后即可勾选「已经阅读完上述注意事项」，进行下一步，如下图所示：
3）点击「下一步」将会出现提示框，若已经按描述完成系统备份则点击「确定」，若未完成备份则点击「取消」返回上一步进行备份，如下图所示：
4）点击「确定」后将进行升级检测，升级检测级别定义如下：
阻塞项：影响升级执行，如不调整无法进行下一步升级
警告项：不影响正常升级但是影响升级后功能使用，需升级后手动处理
提示项：系统自动处理的隐患以及建议您升级后根据配置进行检查项
注：阻塞项、警告项均会在界面上出现提示，提示项需要导出 Excel 查看。
检测内容及提示内容如下表所示：
| 检测项 | 提示信息 | |
|---|---|---|
| 检测磁盘空间 | 磁盘空间检测小于 3G，标记为阻塞项； 检测不到磁盘空间，标记为警告项； | 检测到当前磁盘剩余空间不足 3G，请确保磁盘空间大于 3G 再进行升级，您可以先清理磁盘空间然后进行升级 |
| 检测外置库权限 | 检测外置库 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 文件，标记为警告项 | 检测到有自定义样式或是自定义类，有失效的风险，若失效则升级之后需要重新适配 |
检测完成后如下图所示，可以选择「导出」查看完整的检测结果及修复方案：
5）点击「下一步」即可完成检测，如下图所示：
