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

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

注：linux英文环境下，2018.2.28号—2018.9.6号之间的9.0jar包有问题会导致升级失败，需要先将9.0升级到最新jar包，再使用升级工具升级到10.0。

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

1）提供免安装版程序，点击即可运行，无需安装卸载。注：升级工具请联系技术支持获取。

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

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

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

点击确定，进去FineReport10.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.0jar包有问题，需要先将9.0jar升级最新，再使用升级工具升级到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.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参数