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

注：支持 Windows、Mac、Linux 主流操作系统。

注：国际化用户（英文 English、台湾 Taiwan 等）升级前一定要手动备份数据库信息，因为升级工具会导致删除不同语言下的权限配置。

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

注：升级工具请联系技术支持获取。

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

点击下载程序，如下图所示：

双击程序，选择语言，如下图所示：

点击确定，进去 FineReport 10.0 升级助手的安装程序向导，选择 9.0 工程文件夹（包含WEB-INF的文件夹，一般是WebReport）

注：必须是 9.0 工程且包含 WEB-INF 文件夹，一般是 WebReport。

注：如果所选目录未检测到 WEB-INF 文件夹，则提示「请选择包含 WEB-INF 文件夹的目录」，如果版本非 9.0，则提示「仅支持 9.0 工程」。 

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

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

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

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

注：备份成功后，在设置好的文件夹下生成 WebReport_bak 的备份文件。

升级结束后，界面如下图所示：

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

将环境变量 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 拷贝到此路径下。

将升级后的文件部署到服务器上，即可看到 9.0 工程升级到了 10.0 并保留数据，如下：

注：此处是将升级后的 WebReport 文件夹名称改为了 Webroot。

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

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

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

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

注：Linux 英文环境下，2018 年 2 月 28 号—2018 年 9 月 6 号之间的 9.0 JAR 包有问题，需要先将 9.0 JAR 升级最新，再使用升级工具升级到 10.0。

5）不同的操作系统（Linux、Mac）使用升级工具流程一样。

6）服务器部署过程中若报错 500，则需引入 tools.jar，具体参见：服务器部署需引入 tools.jar。

7）2018 年 11 月 6 号及之后的 JAR，10.0 工程有两个端口，一个是容器的端口：默认为 8075，另一个是 websocket：默认为 38888；当同一个设备上有不止一个 10.0 工程时，两个端口不能同时相同，否则会出现端口被占用报错的问题。解决方案参考：工程端口被占用的处理方法。

8）内网离线环境下，从 9.0 升级上来的工程，无法升级插件商城脚本，目前只能手动替换脚本文件 scripts，替换路径为：%FR_HOME%/webapps/webroot/scripts。

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

9.0 中进行微信/钉钉集成后，通过升级工具进行升级说明：

1）升级工具要求采用 2018 年 11 月 12 号及之后的版本。

2）升级后微信／钉钉的配置会保留。

3）10.0 平台访问路径调整，升级后打开微信／钉钉管理界面，将服务器地址修改为 10.0 平台地址。

4）打开微信／钉钉管理>应用快捷配置，重新生成链接，进入微信／钉钉管理后台修改新的链接。

5）9.0 中开启模板权限时访问单个模板需要用 WeiXinServer，10.0 中已不再需要，直接采用生成的模板链接即可，注意修改微信管理后台绑定的模板链接及定时调度推送的自定义链接。

6）第三方 App 集成 H5 时，如果调用平台 URL，路径格式为 ：http://localhost:8075/webroot/decision/url/mobile，调用单张模板仍然为路径后加上 op=h5 参数。