1.1 功能简介

为满足客户的新需求以及完善之前版本某些功能的不足之处，我们的产品在不断地更新迭代。

若需要修复之前版本中存在的一些问题及增加新的产品功能，就需要用户升级到当前最新版本。

FineReport 10.0 内置一键升级的功能，升级更为方便。

1.2 升级逻辑

1）FineReport 9.0 与 10.0 版本之间没有内置升级功能，用户可通过升级工具完成。

2）JAR 包在 2019-12-05 前的 10.0 报表工程，与JAR 包在 2019-12-05 后的报表工程，两者的更新升级逻辑不同。

• 老版本的更新升级逻辑不够灵活，当需要增删 JAR 包时，只能手动去进行升级操作，提高了维护的成本。

• 新版本的更新升级逻辑，支持更加灵活的更新配置，如 JAR 包的添加、删除

3）为了防止更新后续可能拆 JAR 包等带来的风险，为了不增加冗余的一次性判断逻辑：

• JAR 包在 2019-12-05 前的报表工程进行更新升级，只能更新至 JAR 包在 2019-12-05 的版本。

• JAR 包在 2019-12-05 及以后的报表工程进行更新升级，才允许升级到最新版本。

举例：当前版本为 JAR 包时间在 2019-05-20 的 10.0 报表工程，最新版本为 JAR 包时间在 2020-04-26 的 10.0 报表工程。用户只能先升级至 JAR 包时间在 2019-12-05 的报表工程，才能继续升级至 JAR 包时间在 2020-04-26 的 10.0 报表工程。 

为了帮助用户更顺利的从 9.0 升级到 10.0 版本，我们特提供一个独立的辅助升级程序，可以将 9.0 的 Web 工程升级到 10.0 工程，包括 JAR 包、各类配置文件、FineDB 数据表等文件的兼容升级。 

该辅助升级工具无需安装，即点即用，简单方便。具体可参考：9-10 升级工具

注1：升级工具目前只支持 jdk1.8，用户在升级时要确保自己的 jdk 为 1.8 版本。

注2：9.0 升级 10.0 后，建议新版本的 外接数据库 和旧版本不同；若用户希望使用同一外接数据库，需要将外接数据库中旧版本的工程信息全部删除，否则可能会因为表结构不一致导致一些问题。

3.1 设计器升级

3.1.1 直接更新升级

打开设计器，点击菜单帮助>更新升级，在最新 JAR 一栏会出现新版本号，下方会有更新按钮，如下图所示：

注：远程设计状态下不支持「更新升级」功能。

触发更新后，系统提示保存重要信息，如下图所示：

设计器更新时由于要获取比对 JS 并解析，会出现几秒的延迟，获取更新信息中，如下图所示：

按照提示更新，下方显示下载 JAR 包进度，如下图所示：

等待准备工作完成，系统将立即自动重启。

重启之后最新 JAR 一栏显示为「已经是最新版本」，即完成 10.0 版本更新。

3.1.2 插件管理触发升级

当打开新插件管理器时，如下图所示：

点击服务器，插件管理，若检测到 jxbrowser 的 JAR 包不存在，则弹出强制升级提示框，如下图所示：

点击确定或关闭提示框，将跳转至更新升级界面，后续升级步骤如 3.1.1 章节所示。

3.2 服务器升级

打开数据决策系统，在管理系统>智能运维>备份还原>更新升级点击立刻更新按钮，等待更新 JAR，成功后重启 Web 服务器即可。

注：平台更新升级后，需要通过 Ctrl+C / kill 关闭 Tomcat 进程，使用其他方式会存在一定风险。

4.1 设计器升级

4.1.1 方法一：在线更新 JAR 包

打开设计器，点击菜单帮助>更新升级，在最新 JAR 一栏会出现新版本号，下方会有更新按钮，如下图所示：

注：远程设计状态下不支持「更新升级」功能。

按照提示更新，下方显示下载 JAR 包进度：

等待准备工作完成，点击立即重启。

重启之后最新 JAR 一栏显示为「已经是最新版本」，即完成 10.0 版本更新。

4.1.2 方法二：人工更新 JAR 包

向 FineReport 技术人员索要 13 个的升级 JAR 包：

fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-report-10.0、fine-report-designer-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar

1）fine-report-designer-10.0：这一个 JAR 包包含 FineReport 设计器的所有功能，必须更新，存放在 %FR_Home%/lib 下：

2）其余 JAR 包：升级到版本的时候，需要将剩下的 12 个 JAR 包放到 %FR_Home%/webapps/webroot/WEB-INF/lib下：

注：更新 JAR 包后需要重启设计器才会生效，而且 JAR 包所放位置不能放错，否则会导致不能打开设计器。

4.1.3 方法三：决策平台管理升级

在管理系统>智能运维>备份还原>更新升级点击立刻更新按钮，等待更新 JAR，成功后重启设计器即可。

4.2 服务器升级

4.2.1 方法一：人工更新 JAR 包

向 FineReport 技术人员索要单独的12个升级包：

fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar

将这 12个 JAR 包放到%TOMCAT_HOME%/webapps/webroot/WEB-INF/lib下，重启服务器即可。

注1：以 Tomcat 服务器 为例，在 Linux 中，要先./shutdown.sh，然后用ps -ef|grep tomcat命令来查看系统中是否还有 Tomcat的进程，如果有的话，要先kill -9进程号 干净，然后./startup.sh。

注2：注：2019-12-05 及之后版本的 JAR 包可正常使用 shutdown 完全清理所有进程。

4.2.2 方法二：安装设计器后拷贝 JAR 包

安装最新版本设计器，然后拷贝安装目录下其位置处的包替换要升级服务器下的包，即可进行升级。

注1：更新 JAR 包后需要重启服务器如 Tomcat 才会生效。并且需要保证服务器上和设计器上的 JAR 的版本一致，否则可能会导致某些模板在本地看的效果是正确的，但是放在服务器下面的时候就出问题了。

注2：在进行版本升级时请先查看 升级兼容性 ，有的版本升级时的方式可能会有所差异，大体不变。

4.2.3 方法三：决策平台管理升级

在管理系统>智能运维>备份还原>更新升级点击立刻更新按钮，等待更新 JAR，成功后重启 Web 服务器即可。

注：平台更新升级后，需要通过 Ctrl+C / kill 关闭 Tomcat 进程，使用其他方式会存在一定风险。