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

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

2）程序支持简体中文、英文、繁体中文。

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

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

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

由于 FineReport 功能不断优化，产品不断迭代升级，因此升级工具也在不断更新，本文暂不提供升级工具下载链接，请需要的客户联系帆软技术支持获取。

技术支持联系方式 QQ：800049425，电话：400-811-8890

注：升级前，请仔细阅读以下升级须知。

1）工程备份：升级之前请先关闭待升级的工程，并对此工程进行备份。

2）以管理员方式启动升级工具，保证升级工具能在工程所在的磁盘创建文件夹（一般不要将工程放在C盘内）。

3）当前只支持 JDK1.8，所以升级工程前务必查看 JDK 版本，保证JDK 版本符合要求，否则升级成功后会出现部署报错。

     如果 JDK 环境不允许改动，也可将工程拷贝到 JDK1.8 环境中升级完成后再拷贝回来。

4）内网离线环境下，升级后的工程，插件商城无法伴随升级，升级成功后需要手动替换插件商城脚本文件 scripts 。 

     点击可下载 scripts：scripts.zip

     替换路径为：%FR_HOME%/webapps/webroot/scripts，替换后需重启服务器，并且清除浏览器缓存。

5）如果待升级工程的 finedb数据库 为外接数据库，升级过程中需要确保能够连接到外接数据库。

6）9.0 版本，同步数据集时选择了自定义加密类，升级到 10.0 因接口发生变化都需要参照 10.0 方式重新适配。10.0 中取         消了默认的 MD5加密，若 9.0 选择了内置MD5加密，升级后如仍需使用 MD5 加密请参见 密码加密设置 第 4.3 节。

7）部分插件未支持新版本，在升级前请进行删除。

8）9.0 做了单点登录的工程升级到 10.0 需要重新进行适配。

9）深度集成的客户，建议把数据先拿到独立部署的工程里面，升级完成后，另行适配 10.0。

10）非简体中文系统用户升级前，务必要手动备份数据库信息。升级工具会删除不同语言下的权限配置。

11）Linux 非简体中文环境下，2018-02-28~2018-09-06 之间的 9.0 JAR 包与 10.0 无法完全兼容，需要先将 9.0 JAR 升          级最新，再使用升级工具升级到 10.0。

4.1 升级工具使用

1）右键点击升级工具，选择以管理员身份运行。如下图所示：

2）打开程序后，进行语言选择，可选择简体中文、繁体中文、英语。如下图所示，用户根据实际工程情况选择。

3）点击确定，进入 FineReport 10.0 升级工具的安装程序向导，选择待升级的 9.0 工程文件夹。如下图所示：

注：工程文件夹一般为 %FR9.0_HOME%/WebReport 文件夹，是包含 WEB-INF 的文件夹。

如果所选目录未检测到 WEB-INF 文件夹，会提示：请选择包含 WEB-INF 目录的WEB容器文件夹，用户需检查是否工程文件选择错误。

如果选择的工程版本非 9.0，会提示：仅支持 9.0 的工程升级，用户需检查是否工程文件选择错误。

4）点击下一步，进入原工程备份界面，选择原文件夹备份保存的地址，如下图所示：

注：备份地址不允许为空，为空时提示：您必须输入备份目录

5）点击下一步，提示：即将开始升级，在升级过程中请勿关闭本程序，同时不要对原工程做任何编辑修改操作。如下图所示：

6）点击下一步，启动备份升级，如下图所示：

备份成功后，在设置好的文件夹下生成 WebReport_bak 的备份文件。如下图所示：

7）升级结束后，显示升级完成，界面如下图所示：

8）点击完成后，9.0 中的项目文件 WebReport 就是被升级后的文件。如下图所示：

4.2 引入tools工具包

因 10.0 部署除了需要有 JRE 以外，还需要 JDK 中的 tools.jar，所以升级工具升级完工程后，还需要引入 JDK 中的 tools.jar 工具包。如不执行此步骤，服务器部署过程中会报错 500，相关内容可参考： 服务器部署需引入 tools.jar

将 %JAVA_HOME%/jdk/lib 下的环境变量tools.jar放到 %TOMCAT_HOME%/lib 和或%TOMCAT_HOME%/webapps/工程名/WEB_INF/lib下，如下图所示：

注：若环境变量指向的%JRE_HOME%/bin下无attach.dll文件，还需将%JAVA_HOME%/jdk/jre/bin下的attach.dll拷贝到此路径下。

4.3 启动工程

若升级后的工程需要部署，参考帮助文档部署集成章节，完成部署即可。

启动工程，登录决策系统，即可看到 9.0 工程升级到了 10.0 并保留平台数据，如下图所示：

注：升级后登录平台的 URL 发生变化，需要修改为 10.0 支持的 URL 格式，才能正常访问，如本地服务器可修改为：http://localhost/WebReport/ReportServer?op=fs  或  http://localhost/WebReport/decision

5.1 升级工具闪退

问题描述：升级过程中，可能会因为一些原因导致升级工具闪退。

解决方案：如发生闪退情况，请联系帆软技术支持，并发送error.log文件，如下图所示：

1）windows：error.log在升级工具同级文件夹生成

2）linux：如升级失败，日志会保存在/tmp目录下，如升级成功，该日志将自动删除，如下图所示：

5.2 Unsupported major.minor version 52.0

问题描述：工程可以升级成功，但升级后部署报错：com/sun/tools/attach/VirtualMachine:Unsupported major.minor version 52.0

原因分析：升级工具仅支持 JDK1.8 环境，其他版本的 JDK 环境不支持

解决方案：

1. 直接更换为 JDK1.8 的环境再升级

2. 客户的工程拷贝到另外一个 JDK1.8 的环境进行升级，完成后再拷贝回其他的环境

5.3 权限丢失

问题描述：2018-02-28~2018-09-06之间的 JAR 包，Linux 英文/繁体中文环境下，所有部门所有职务存在遗留问题，导致权限会存在所有部门所有职务或者All DepartmentAll Post上。

解决方案：由于升级工具会根据 JAR 包时间以及升级的语言环境升级对应的权限，因此直接将9.0 JAR升级至最新，再使用升级工具升级到 10.0 即可。

5.4 端口被占用

原因分析：2018-11-06及之后的 JAR 包。10.0 工程有两个端口，一个是容器的端口：默认为 8075，另一个是 websocket：默认为 38888。当同一个设备上有不止一个 10.0 工程时，两个端口不能同时相同，否则会出现端口被占用报错的问题。

解决方案：工程端口被占用的处理方法

5.5 其他说明

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

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

3）升级到 10.0 后，迁移过的 FineDB 会从数据库回退到原先的 FineDB ，需要重新迁移。

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

5）2019 年 4 月 15 号及之后的升级工具支持官方的数据集类插件，支持列表如下：

确认一下是直接通过设计器升级的工程，载部署，还是可以直接在工程上升级