1. 概述
1.1 版本维护策略
FineReport 在 2021 年 10 月发布了 11.0 ，我们在 BI 5.1.19 版本开始对 FR 11.0 版本进行了适配，版本号为 5.1.19+ 版本。
与此同时，由于仍有大量客户继续使用依赖 FR10.0 版本的FineBI，所以我们后续也同时维护适配 FR10.0 的版本，版本号为 5.1.18.x 版本。
所以后续 BI 将会有两个 5.x 版本同时维护和发布，即：
5.1.18.x 版本（5.1.18.22，5.1.18.23，5.1.18.24……）：适配 FR 10
5.1.19+ 版本（5.1.19，5.1.20，5.1.21，5.1.22……）：适配 FR 11
意味着 5.x 版本客户可以按需同步配套使用 FR10.0/FR11.0 ，均对其进行维护。
1.2 升级策略及建议
BI 升级团队升级 5.1.x 版本时将主推 5.1.18.x 版本（适配 FR 10），但不严格限制，如果有其他必要原因也可以升级 5.1.19+ 版本（适配 FR 11）。
同时，也建议客户优先升级到 5.1.18.x 版本（适配FR 10），如果客户已经购买并使用了FR11版本，且需要配套使用BI，则可以推荐客户升级5.1.19+版本（适配FR 11），升级注意事项见下一部分。
2. 升级前注意事项
2.1 升级路径
从 5.1.18 版本之后分出 2 个小版本，分别适配FR10及FR11，升级路径如箭头所示：
5.1.18 版本，可以选择以下两种升级方式
5.1.19+ ，在该路径上可以按序升级（5.1.18 → 5.1.19 → 5.1.20 → 5.1.21 → ……），可以跳跃升级（例如 5.1.18 → 5.1.20）
5.1.18.x ，在该路径上可以按序升级（5.1.18 → 5.1.18.22 → 5.1.18.23 → 5.1.18.24 → ……），可以跳跃升级（例如 5.1.18.22 → 5.1.18.24）
2.2 升级方式
升级 5.1.19 及往后版本必须使用升级工具（详情请见：FRBI升级工具(适配FR11)），且升级后 lic 会失效，必须更换 11 版本的 lic ；
若已升级到适配 11.0 的版本，则直接换 jar 升级即可。
工具适配版本
FRBI升级工具(11.0.1+5.1.19)
5.1.15（jar日期为：2021.08.05）至5.1.18版本才可以使用此工具；如果是5.1.15之前的版本，需要将工程先升级到 5.1.15 至 5.1.18 之间的任意版本，再使用从工具升级；
FRBI升级工具(11.0.2+5.1.20)
5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具；
FRBI升级工具(11.0.3+5.1.21)
5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具；
FRBI升级工具(11.0.4+5.1.22)
5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具。
注：升级工具仅维护到5.1.22-2022/04/29版本，若客户需升级2022/04/29以后的5.X版本，需先升级到任意5.1.19及以后版本，再换jar升级。
2.3 其他事项
1）适配不同 FR 版本的 BI 版本间不能交叉升级，例如 5.1.18.22 可以升级到5.1.18.23，但不能升级到 5.1.23 ；
2）6.0 版本发布后，5.1.x 版本（包括 5.1.18.x，5.1.19+）均可直接升级 6.0 版本。
3. 升级准备注意事项
3.1 通用注意事项
【必做】从低版本升级到高版本：中间的每个版本注意事项都得过一下；
【必做】必须备份好webroot（配置了外接数据库同时备份平台配置）；
【必做】由于BI 5.1.18版本适配FR 10.0版本，BI 5.1.19版本开始适配FR 11.0版本，升级5.1.19及往后版本必须使用升级工具，且升级后lic会失效，必须更换11版本的lic；若已升级到适配11.0的版本，则直接换jar升级即可。详见本文 2.2 节；
【选做】 h2-1.4.192.jar 存在高危漏洞 CVE-2021-23463 ，若未使用 demo 库可自行替换最新版本的 h2 驱动，若客户有使用 h2 1.x 的数据库，升级到 2.x 存在兼容问题，需要重新生成库或者自行评估是否替换；
3.2 5.1.18升级5.1.18.x(FR10.0)
5.1.22
需要删除「字段分组」插件
5.1.21
升级工具使用：5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具：FRBI升级工具(11.0.3+5.1.21)
5.1.20
升级工具使用：5.1.5（jar日期为：2020.08.07）至5.1.18版本均可以使用此工具：FRBI升级工具(11.0.2+5.1.20)
5.1.19
升级5.1.19版本，使用sqlserver外置库的客户首次启动会慢，建议切换内置库升级后再迁移，或换mysql/oracle外置库。；
升级工具使用：5.1.15（jar日期为：2021.08.05）至5.1.18版本才可以使用此工具；如果是5.1.15之前的版本，需要将工程先升级到5.1.15至5.1.18之间的任意版本，再使用从工具升级。
3.3 5.1.18升级5.1.19+(FR11.0)
5.1.18.22
需要删除「字段分组」插件
4. 使用升级工具升级
使用升级工具升级步骤详情请参见文档：FRBI升级工具(适配FR11)
