Windows系统10-11升级步骤

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升级前准备

升级思路导图如下：

2.1 升级工程

1）先将升级工具上传到服务器端

2）关闭工程后，以管理员身份启动升级工具，如下图所示：

3）将会出现前台操作面板，输入工程路径，如下图所示：

注：需要输入待升级的工程路径，是容器比如tomcat下的webroot，不是设计器目录下

4）点击「..」，选择备份工程的路径（此步骤可跳过），如下图所示：

若不选择「备份路径」直接进行开始升级，将会出现提示：未选择备份目录将跳过备份直接升级，请提前确认已备份原工程和配置数据，是否确认跳过备份，选择「Yes」将直接开始升级，如下图所示：

5）点击「开始升级」，将会显示升级进度，升级成功后，将会显示 upgrade success，如下图所示：

6）手动关闭升级操作面板。

7）升级成功后，启动 Tomcat

指令切换到 tomcat/bin 目录下，双击 startup.bat 启动 tomcat（按照自己的启动方式去启动工程即可），访问决策平台，和原 10.0 的访问路径一致。

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

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

2.2 配置外接数据库

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

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

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

注2：为了和旧版本的外接库互相独立，不影响之前的环境，可以在原来所用数据库实例的相同用户下，新建一个数据库做迁移。待后续 11 运行稳定，可以将原先 10 的外接库删除。如果已经在准备工作中做好，直接用建好的实例即可。

思路导图如下：

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

1）按照文档2.1节，先对节点一进行升级。

2）节点一升级好后，利用 10-11升级前准备 中建好的表空间，进行外接库迁移，参考文档中的步骤4 。

3.2 确认单节点集群配置正常

配置好外接库后，集群配置默认保留，确认节点管理无飘红即可继续进行下一步。

3.3 同步升级文件

1）关闭所有节点的tomcat，删除未升级节点 webroot 下的WEB-INF文件夹（删除前请确认已经做好备份工作）。

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

3）依次启动各个节点 tomcat，启动成功后即可看到原始集群升级成功。

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

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

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

3）升级工具不能跨版本升级，如 9.0 工程想升级到 11.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）Window 系统升级失败时，前台操作面板会提示失败显示具体的失败原因和信息。

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

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