1. 描述html
现提供一个独立的辅助升级程序，能够将 9.0 的 Web 工程升级到 10.0 工程，包括 JAR 包、各种配置文件、FineDB 数据表等的兼容升级。linux
1） 提供免安装版程序，点击便可运行，无需安装卸载。web
2）程序支持简体中文、英文、繁体中文。shell
3）支持 Windows、Linux 主流操做系统。数据库
注：请在升级前仔细阅读 9-10兼容说明windows
2. 获取升级工具浏览器
因为FineReport功能不断优化，产品不断迭代升级，所以升级工具也在不断更新。缓存
帆软技术支持提供服务器
3. 升级前准备websocket
1）工程备份：升级以前请先关闭待升级的工程，对此工程进行备份。
2）以管理员方式启动升级工具，保证升级工具能在工程所在的磁盘建立文件夹（通常不要将工程放在C盘内）。
3）当前只支持JDK1.8，因此升级工程前务必查看JDK版本（若是环境不容许改动，请将工程拷贝到jdk1.8环境中升级再拷贝回来）,不然升级成功后会出现部署报错
4）内网离线环境下，从 9.0 升级上来的工程，没法升级插件商城脚本
升级成功后须要手动替换脚本文件scripts，替换路径为：%FR_HOME%/webapps/webroot/scripts，替换后重启服务器，而且清除浏览器缓存
注：点击下载 scripts：scripts.zip
5）如待升级工程进行过平台数据库迁移，升级过程当中须要确保可以链接到外接数据库。
6）9.0及之前版本同步数据集中密码能够选择内置MD5加密，升级后如仍需使用 MD5 加密请参见：MD5 加密方式
若是之前用户存的是明文，升上来之后，再也不能登陆上了，只能去重置；其余全部自定义加密类升级到10.0都须要从新适配
7）部分插件未支持新版本，在升级前请进行删除。
8）单点登陆的客户升级到 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. 升级步骤
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 升级后部署
1）将 %JAVA_HOME%/jdk/lib 下的环境变量tools.jar 放到%TOMCAT_HOME%/lib或%TOMCAT_HOME%/webapps/工程名/WEB_INF/lib下，以下图所示：
注：如不执行此步骤，服务器部署过程当中会报错 500，详情请参见：服务器部署需引入 tools.jar。
注：若环境变量指向的%JRE_HOME%/bin 下无attach.dll 文件，还需将%JAVA_HOME%/jdk/jre/bin 下的attach.dll 拷贝到此路径下。
2）将升级后的文件部署到服务器上，便可看到 9.0 工程升级到了 10.0 并保留数据，以下图所示：
注：此处是将升级后的 WebReport 文件夹名称改成了 webroot。
5. 常见问题
5.1 升级工具闪退
问题描述：升级过程当中，可能会由于一些缘由致使升级工具闪退。
解决方案：如发生闪退状况，请联系技术支持解决，并发送error.log文件，文件位置以下：
1）windows：error.log在升级工具同级文件夹生成
2）linux：不生成日志文件，升级过程在控制台输出日志，须要升级前手动保存控制台信息，如xshell
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 号及以后的升级工具支持官方的数据集类插件，支持列表以下：
| 插件 |
| 多维数据集 |
| SAP 数据集 |
| JSON 数据集 |
| MongoDB 数据集 |
| 新 SAP BW 数据集 |
| 螺旋数据集 |