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

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

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

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

注1：升级前请先仔细阅读：10-11 兼容说明

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

注3：升级工具仅支持 JAR 包日期为 2020-08-04 及之后的 FineReport 10.0 版本进行升级。目前升级工具仅支持 10.0 版本升级至 11.0.3 版本。

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

2.1 升级技术协助

Finereport 大版本升级技术协助，目前由专属的升级团队负责，您可以通过提交「升级风险评估书」，做个简单的前置环境信息了解，评估书链接如下：升级风险评估书 。在提交「升级风险评估书」后会自动进入系统排队，升级团队会在您填写的预期升级时间内，主动与您取得联系，对接具体升级事宜，商务问题请联系您的销售经理进行确认。

2.2 升级工具获取

由于 FineReport 功能不断优化，产品不断迭代升级，因此升级工具也在不断更新，本文暂不提供升级工具下载链接。您可以选择直接提交风险评估书，届时升级团队会给您发放；或者联系技术支持获取。技术支持联系方式 QQ：800049425，电话：400-811-8890

1）磁盘容量：由于升级工具体积较大，升级过程会对必要的文件进行解压，同时会对 10.0 进行整体 webroot 备份，所以升级工具所在磁盘保证剩余容量大于 3G ，备份路径所在磁盘保证剩余容量大于 webroot 工程大小。

2）工程及升级工具路径：升级工具和工程所在路径不要包含较多特殊字符，可包含中文、英文、数字、英文括号、下划线、英文连接符、空格（一般不要将工程放在 C 盘内）。

3）关闭工程：升级之前请先关闭待升级的 10.0 工程。

4）工程配置：10.0 工程如果配置了外置库、状态服务器、文件服务器，升级过程需要保证均可以正常连接以便更新文件。

5）端口占用：升级过程会占用 20216 和 20217 端口

6）升级环境：支持断网升级，支持无 JDK 环境升级

7）工程配置：支持对单机工程和集群工程进行升级。集群升级时，只对单节点进行升级，升级成功后将升级成功的 webroot 拷贝替换至其他节点下。

注：10.0 升级到 11.0 时，需要手动将各个节点对应的 webroot/logs 进行备份，在升级完成后再将 logs 拷贝到升级后的 webroot 文件夹下（相当于保留原各节点下 logs）再启动工程 。

8）定制情况：10.0 工程存在定制情况，比如 JAR 定制、外置库定制、二开、集成定制等，请提前与技术支持确认升级后是否兼容以及如何兼容适配。

9）插件适配：当前 FR11.0 只适配了官方插件，所以第三方插件、定制插件可能会出现升级后无法使用的情况。

10）外接数据库：如果配置了外接数据库，建议先将外接数据库进行备份，备份后切换到备份数据库升级。升级工具会将外接数据库转为内置数据库后再进行升级。升级成功后用户只需要重新迁移外接数据库即可。

11）JAR 包版本：在进行升级前需要将 JAR 包升级至 2020-08-04 及之后的日期。若未将 JAR 包未升级至 2020-08-04 就使用升级工具进行升级，将会提示报错：工程版本低于2020.08.04，无法升级，建议更新后再尝试升级。

1）将升级工具上传至 Linux 系统中，手动赋予执行权限：chmod +x FineUpgrade_v11_linux_xxx.sh，如下图所示：

2）根据命令行提示，手动输入 webroot 路径 ，如下图所示：

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

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

4）点击「开始升级」，将会显示升级进度，升级成功后，将会显示 upgrade success。

5）升级完成 10.0 中的项目文件 webroot 就是被升级后的文件。

• 升级成功后 webroot/WEB-INF/lib 下 fine 开头的 10.0 jar 包会统一替换为 11.0 jar 包。

• 升级成功后，webroot/plugin 文件夹下部分插件可能会同时存在 10.0 和 11.0 插件包。10.0 插件包中会包含 .delete 文件，工程启动后就会自动删除 10.0 插件包。

6）外接数据库迁移请参考本文 5.6 节。

注：10.0 升级到 11.0 时，需要手动将各个节点对应的 webroot/logs 进行备份，在升级完成后再将 logs 拷贝到升级后的 webroot 文件夹下（相当于保留原各节点下 logs）再启动工程 。

7）集群迁移请参考本文 5.7 节。

5.1 平台备份

使用管理账号登录数据决策系统，在「管理系统>智能运维>备份还原>平台配置」中选中手动备份。默认备份路径为：.../backup，备份文件储存在工程的 %FR_HOME%/webapps/webroot/backup 文件夹下。

5.2 备份整个 Tomcat

原来的 10.0  的工程在 tomcat10 中，把 tomcat10 复制一份，重命名为 tomcat11 。

5.3 备份 Tomcat11 还原内置 finedb

1）进入工程的/webapps/webroot/backup/config/manual/下，找到最新的日期的文件夹（eg：2022-04-13-13:47:53，文件夹名字是手动备份的时间），其中 config.zip 里面存放的是转换为内置库模式的 finedb 。

2）解压 config.zip 文件，将解压后的 finedb 文件拷贝到备份工程的/webapps/webroot/WEB-INF/embed中，替换掉之前的 finedb 文件夹（按照 tomcat10 为原始环境，tomcat11 为备份环境来看，就需要将tomcat11/webapps/webroot/WEB-INF/embed中的 finedb 替换掉）。

3）再进入备份tomcat11/webapps/webroot/WEB-INF/config目录，删除 db.properties 配置文件（该文件保存了外接数据库的配置）。

4）tomcat11 完成转换为内置 fiendb 模式，至此 tomcat11 和原先的 tomcat10 完全独立，互不影响，但是不能同时启动（端口占用导致不能同时启动）。

5.4 对内置 finedb 工程升级

1）使用上传工具将升级工具上传到服务器端，升级工具放在/opt目录下。

2）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

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

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

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

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

5.5 启动 Tomcat

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

5.6 外接库迁移

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

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

注2：如果是迁移到mysql数据库，建议新建一个区分大小写的数据库再做迁移。

5.7 集群迁移

将集群单个节点升级后，启动进入平台配置外接库（如果 5.6 节已经做了外接库配置则无需在配置），具体页面如图：

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

关闭 tomcat，复制 webroot 到另一个节点（必须要在配置了外接库，开启集群后才行），依次启动两个节点 tomcat，集群配置成功。

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）日志关键字对照说明：部分升级进程关键字如下表，若有模块升级失败可对应查找关键字确认。