由于 FineBI 5.1.19 适配的 FineReport 11.0.1属于大版本更新，因此必须更换 Lic ，若有疑问，请请前往 【服务平台>在线支持】联系技术支持获取帮助。
1. 概述
1.1 版本
| FineBI 版本 | 内容变动 |
|---|---|
| 5.1.19（适配 FR 11.0.1） | BI 5.1.15（JAR 日期为：2021.08.05）至 5.1.18 版本才可以使用此工具 注：如果是5.1.15之前的版本，需要将工程先升级到5.1.15至5.1.18之间的任意版本，再使用本文工具升级。 |
| 5.1.20（适配 FR 11.0.2） | BI 5.1.5（JAR 日期为：2020.08.07）至 5.1.18 版本均可以使用此工具。 |
1.2 应用场景
FineBI 5.1.19 适配 FineReport 11.0.1，因此提供该升级工具，若你需要将 BI 工程升级至 5.1.19 以及之后的版本，可参考本文进行升级操作。
1.3 使用范围
见本文 1.1 节功能变动。
版本信息可在 注册管理 中查看。
1.4 注意事项
1.4.1 升级前必看
升级前的注意事项详情请参见文档：BI5.x版本适配FR10.0/11.0维护策略公告
1.4.2 集群升级
集群环境升级请先停止所有节点的进程，在其中任一节点运行升级工具，完成升级后将当前节点的 webroot 文件下的 WEB-INF、scripts、upm 拷贝到其他节点，完成后先启动一个节点，待工程可以访问后，再依次启动其他的节点。
如果配置了外接数据库、状态服务器、文件服务器，升级过程需要保证均可以正常连接，以便更新文件。
1.4.3 更换 netty JAR包
5.1.26之前版本升级至5.1.26及之后版本，请手动删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib下 netty 相关 jar 包。
5.1.26及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能，因此需要删除额外的jar，否则可能无法正常启动工程。
如需从高版本回退至5.1.26之前版本，需要额外在服务器工程 %Tomcat_HOME%/webapps/webroot/WEB-INF/lib 目录下加上netty相关jar包。点击下载JAR包：netty安全驱动
2. 操作步骤
2.1 获取升级工具
若您是未联系帆软销售经理的个人用户，可致电 400-8118890 转1 与帆软商务联系获取相关资讯；
若您已与帆软销售经理有对接，请前往 【服务平台>在线支持】获取升级工具和 「BI升级」插件包。
2.2 确认已有的注册功能
由于升级后必须更换 Lic 文件，因此在升级前可先确定已有的注册功能点，详情参见：注册管理。
2.3 工程备份
进入「管理系统>系统管理>常规」，确认数据库类型，如下图所示：
如果显示「待配置」：则数据库类型为内置数据库
如果显示「已配置」：则数据库类型为外置数据库
内置数据库备份方式：
关闭 FineBI 工程，在路径%FineBI%\webapps\webroot下拷贝 webroot 文件夹（备份的 webroot 文件不能放在 FineBI 的安装路径下）
注：如果 webroot 比较大（超过4G），备份需要的时间太长，可以只备份 webroot 下的 WEB-INF 文件夹；如果 WEB-INF 也非常大（超过2G），备份需要的时间还是特别长，可以只备份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources 文件夹。
外接数据库备份方式：
方案一：
1）关闭 FineBI 工程，在路径%FineBI%\webapps\webroot下拷贝 webroot 文件夹（备份的 webroot 文件不能放在 FineBI 的安装路径下）
注1：如果 webroot 比较大（超过 4G），备份需要的时间太长，可以只备份 webroot 下的 WEB-INF 文件夹；如果 WEB-INF 也非常大（超过 2G ），备份需要的时间还是特别长，可以只备份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources文件夹。
注2：集群环境有几个节点则备份几个 webroot 工程。
2）手动备份好外接数据库，备份数据库的密码需要和之前数据库的一致。
方案二：
进入「管理系统>智能运维>备份还原」，分别对「平台配置 、报表模板、BI模板、Jar包、插件」进行「手动备份」，如下图所示：
注：2020.01.15 之前发布的 FineBI 不能成功备份钉钉配置。
2.4 进行升级检测
参考 5.1.5-5.1.18版本升级指南 2.2 节内容进行升级前的检测，并根据你的实际情况修改「阻塞项」和「建议项」。
2.5 关闭工程
备份完成后关闭 BI 工程。
常见问题：Windows系统直接关闭工程后，往往防宕机插件进程还在，会导致升级过程替换 jar 失败，从而升级失败。
处理方法：1）进入cmd；2）输入 jps ，查看是否有名字为 Operation 的进程；3）如果有，输入taskkill /f /pid %pid%，杀掉名字为Operation的进程。如下图所示：
验证是否完全关闭的方法：修改%FineBI%\webapps\webroot\WEB-INF下的 lib 文件的文件名称，能修改，则说明工程已经完成关闭。（修改后要记得名字改回来）
2.6 运行升级工具
注1：升级过程会占用 20216 和 20217 端口，请确认端口未被其他进程占用。
注2：升级工具运行时的内存默认为 Xms:4G -Xmx：物理内存的一半，需要保证服务器至少有8G的可用内存，防止升级过程内存溢出。
注3：集群环境只能对一个节点进行升级，升级后将升级好的webroot拷贝到其他的节点。
注4：升级工具日志在工具同级目录下，名字为 upgrade.log。
2.6.1 Windows 系统升级
运行升级工具，选择BI 工程 webroot 所在的位置，然后点击开始升级，如下图所示：
注：升级工具和工程所在路径不要包含较多特殊字符，可包含中文、英文、数字、英文括号、下划线、英文连接符、空格（一般不要将工程放在 C 盘内）。
等待升级完成，如下图所示：
注：升级完成后，启动之前检查 %FineBI%/webroot/WEB-INF/lib下的 jar 是否正确，因为 windows 环境特性，文件被系统占用，可能删不掉10.0的 jar。
2.6.2 Linux 系统升级
在 Linux 系统中下载升级工具后，使用命令 chmod 777 升级工具 sh 文件名给工具授予权限，如下图所示：
然后启动升级工具，如下图所示：
输入工程 webroot 路径，并等待升级，如下图所示：
升级完成后提示：升级成功，如下图所示：
2.7 重启工程
升级结束，工程处于关闭状态，需要手动启动工程。
2.8 更换 Lic 文件
升级至 5.1.19 后，需要更换Llic，更换的 Lic 功能与之前的 Lic 功能需要保持一致，详情参见：注册管理
3. 注意事项
3.1 插件
当前 FR11.0 只适配了官方插件，所以第三方插件、定制插件可能会出现升级后无法使用的情况。
3.2 其他
如果一个工程已经升级过，不管是否升级成功，都不要再次运行升级工具来升级。需要恢复备份，重新升级。
如果工程配置了外接数据库，升级工具自带的数据库驱动可能连不上外接数据库，导致升级失败，此时建议切换为内置数据库进行升级后，再迁移出去。
