1.1 功能简介

本文通过一个独立的辅助升级程序，可以将 10.0 的 Web 工程升级到 11.0 工程，包括 JAR 包、插件、各类配置文件、FineDB 数据表等的兼容升级。

1）提供免安装版程序，点击即可运行，无需安装卸载。

2）程序支持 4 种语言是简体中文、繁体中文、英文、日文、韩文。

3）支持 Windows、Linux 主流操作系统

1.2 注意事项

1）已获取授权的 10.0 且可用的工程，升级前请先与销售联系，申请迁移授权，升级后，工程需要重新授权。

2）升级工具仅支持 JAR 包日期为 2020-08-04 及之后的 FineReport 10.0 版本进行升级。目前升级工具仅支持 10.0 版本升级至最新的 11.0.X 版本。

注）升级工具是针对报表工程进行升级，如果是用户本地的设计器，需要自行下载 11.0 版本的设计器，再远程连接到报表工程中：下载 FineReport

4）升级工具的获取以及准备工作，注意事项等，请仔细阅读：10-11升级前准备 。

升级思路导图如下：

1）使用上传工具将升级工具上传到服务器端，升级工具选择一个目录放入即可（不要放到tomcat下面）。

2）关闭工程，可参考文档的第2小节：关闭重启工程第2节

3）cd 到升级工具目录，然后执行 chmod +X 文件名称 给升级工具赋权，再启动升级工具，代码和效果如下图所示：

注：FineUpgrade_v11_linux_xxx.sh 代表升级工具名称。

代码如下：

cd /opt
chmod +x FineUpgrade_v11_linux_2022-02-09-amd64-CN.sh
./FineUpgrade_v11_linux_2022-02-09-amd64-CN.sh

4）输入工程路径，以上述 tomcat11 为例，路径是 /opt/tomcat11/webapps/webroot ，如下图所示：

根据提示选择是否跳过备份，输入 N 则出现提示：请选择备份路径，输入备份路径后即可正常升级，如下图所示：

输入 Y 后回车出现提示：未选择备份目录将跳过备份直接升级，请提前确认已备份原工程和配置数据库，是否确认跳过备份，输入 Y 后即可正常升级，如下图所示：

5）升级成功后出现将会显示 upgrade success。

6）升级成功后启动 Tomcat，指令切换到 tomcat/bin 目录下，执行 ./startup.sh，启动成功后访问决策平台，跟原先 10.0 的访问路径一致。

平台访问URL：http://IP:端口/webroot/decision（其中，webroot为工程名，decision为Servlet名）

模板访问URL：http://IP:端口/webroot/decision/view/report?viewlet=xxx.cpt或者xxx.frm

升级工具处理后，平台是默认的内置 finedb 模式，如果需要迁移到自己的数据库，需要重新迁移相关文档见：配置外接数据库。

请按照对应数据库的文档，严格遵循建表的编码等说明进行建表，否则会导致迁移失败。常见外接库的迁移报错如下：外接数据库配置常见问题 。

注1：升级工具不会修改原外接库里的任何数据，而是读取数据生成内置库进行升级修改的。

注2：为了跟原先 10 的外接库互相独立，不影响之前的环境，建议新建一个数据库做迁移，后续 11 运行稳定，可以将原先 10 的外接库删除。

5.1 升级单节点后确认配置好外接数据库

按照上述方法将集群单个节点升级后，确认配置好外接数据库，如下图所示：

5.2 开启集群

集群配置还在，点击开启集群即可，集群配置默认保留，如下图所示：

5.3 同步升级文件

1）关闭所有节点的tomcat，删除未升级节点 webroot 下的scripts、WEB-INF文件夹（删除前请确认已经做好备份工作），否则后续覆盖文件会导致10版本的文件还在，启动异常。

2）复制升级好的节点 webroot 下的WEB-INF文件夹到其他的节点（必须要在配置了外接库，开启集群后才行），并删除WEB-INF\config文件夹下的 cluster.properties 文件后，依次启动各个节点 tomcat，集群配置成功。

用户在进行升级后若遇到严重的故障可回退到之前的版本，回退方案详情参见：10-11后回退至原版本。

1）升级工具只对 Web 工程的升级，不提供对完整设计器的升级。设计器如果需要升级，可以先全新安装 11.0，然后将老设计器下的工程升级到 11.0 后，将升级后的工程拷贝到新安装的 11.0 设计器目录下（也就是将 11.0 webapps 目录中的 webroot 文件替换为升级后的工程文件）。

2）如果一个 Web 工程已经升级过，不管是否升级成功，都不要再次运行升级工具来升级。只能通过已备份的 10.0 工程重新执行升级。

3）升级工具不能跨版本升级，如 9.0 工程想升级到 10.0，需要把工程先升级到 10.0，再从 10.0 升级到 11.0。

4）若 10.0 工程已经配置 tools.jar ，则不需要重新引入 tools 工具包，相反则要将 %JAVA_HOME%/jdk/lib 下的环境变量 tools.jar 放到 %TOMCAT_HOME%/lib 和或 %TOMCAT_HOME%/webapps/工程名/WEB_INF/lib下，若不执行此步骤服务器部署过程中会报错 500。相关内容可参考：tools.jar不存在

5）升级工具支持官方的数据集类插件，支持列表如下：

6）Linux 升级失败时，会提示失败显示具体的失败原因和信息，建议使用 lsof -i:20216 和 lsof -i:20217 查找 pid，若找到 pid 则杀掉后在进行重新升级。

7）10.0 升级到 11.0 时，备份默认跳过 schedule、backup、logs 三个目录，若升级失败，需要将原工程下的 schedule、backup、logs 三个文件手动拷贝到备份的目录下后，切换到备份的路径下即可正常使用。

8）日志关键字对照说明：部分升级进程关键字如下表，若有模块升级失败可对应查找关键字确认。