1.1 功能简介

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

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

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

1.2 升级逻辑

注1：8.0 升级 10.0，要先升级到 9.0，再升级至 10.0。8.0 升级 10.0 可参考 ：FineReport8.0版本升级9.0

注2：用户在进行升级前，为避免升级失败出现文件丢失的情况，请将所需要的文件进行备份后再升级。备份可参考：备份还原

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

2）10.0 版本之间的升级一般为固定的 JAR 包更新，也可能会存在增删 JAR 包的情况，2019-12-05 后的 JAR 包版本自动更新功能有变动。

• 2019-12-05 之前的版本，自动更新升级不够方便，当需要增删 JAR 包时，只能进行手动升级操作。

• 2019-12-05 之后的版本，自动更新升级可以自动增删 JAR 包。

3）为预防后续更新可能会拆 JAR 包带来的风险，2019-12-05 之前的版本更新时有一些限制。

• JAR 包在 2019-12-05 前的版本进行自动更新升级，只能更新至 JAR 包在 2019-12-05 的版本。

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

举例：当前版本 JAR 包时间为 2019-05-20 ，最新版本 JAR 包时间为 2020-04-26 。用户只能先升级至 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 章节所示。

注：设计器手动更新至 10.0.18 版本时，jxbrowser 的 JAR 包需要新增 jxbrowser-7X.jar、jxbrowser-swing.jar、jxbrowser-XX.jar（XX指代系统版本）存放在 %FR_Home%/lib 下，原 jxbrowser 的 JAR 包需保留。JAR 包请联系帆软技术人员索要。

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 服务器升级

注1：在进行版本升级时请先查看 升级兼容性 ，部分版本升级方式可能会有所差异。

注2：服务器上和设计器上的 JAR 的版本要保持一致，否则可能会导致某些模板本地看预览效果正常，服务器下预览出现问题。

4.2.1 方法一：人工更新 JAR 包

用户可以获取 JAR 包后手动替换更新， linux 系统和 windows 系统下操作方式一致。

用户可以向 FineReport 技术人员索要如下 12 个升级包，也可以安装最新版本设计器后在安装目录 %FR_Home%/webapps/webroot/WEB-INF/lib 下拷贝。

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

获取后，替换服务器工程 %TOMCAT_HOME%/webapps/webroot/WEB-INF/lib下之前的 12 个 JAR 包，重启服务器即可完成升级。

注1：更新 JAR 包后需要重启服务器才会生效。Linux 系统下，重启时请参考：关闭 FineReport 工程

4.2.2 方法二：决策平台管理升级

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

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