1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.0.9 | 产品内置了netty-all-4.1.78.Final.jar相关功能，升级11.0.9及之后版本，需要删除原有netty相关jar包 |
| 11.0.20 | 升级11.0.20及之后版本，需手动更新jxbrowser文件 |
1.2 功能简介
为满足客户的新需求以及完善之前版本某些功能的不足之处，我们的产品在不断地更新迭代。升级分为设计器升级和服务器升级。
服务器升级：操作对象一般为系统管理员，负责将公司测试环境和正式环境工程进行升级，以便修复之前版本中存在的一些问题及增加新的产品功能。
如需进行服务器工程升级，请参考：工程升级指南
设计器升级：操作对象一般为设计模板的用户，为了保持和公司系统的一致性，对本地设计器进行升级。
不提供跨大版本（例如FineReport10.0升级FineReport11.0）的设计器升级方案，请直接重新下载并安装设计器。
本文主要介绍设计器在小版本内（例如FineReport11.0.5升级FineReport11.0.9）升级的两种升级情况，请根据实际情况选择适用方案。
| 方案 | 适用场景 | 方案说明 |
|---|---|---|
| 外网升级最新版本 | 需要远程连接的服务器工程为FineReport11.0最新版本 设计器目前处于FineReport11.0版本 设计器环境处于外网，支持在线升级 | FineReport11.0低版本设计器，在线升级到FineReport11.0最新版本 |
| 外网升级指定版本/内网升级 | 1）场景一： 需要远程连接的服务器工程为FineReport11.0最新版本 设计器目前处于FineReport11.0版本 设计器环境处于内网，无法在线升级 2）场景二： 需要远程连接的服务器工程为FineReport11.0较新版本（非最新版本） 设计器处于FineReport11.0大版本 | FineReport11.0低版本设计器，手动升级到FineReport11.0最新/指定版本 |
2. 外网升级最新版本
本节方案：FineReport11.0低版本设计器，在线升级到FineReport11.0最新版本
2.1 备份设计器
在进行设计器升级前，为避免升级失败出现文件丢失的情况，请务必对设计器工程进行备份后再升级。
推荐直接备份%FineReport_HOME%\webapps\webroot文件夹。
2.2 在线更新
1）打开设计器。
2）确保从远程设计状态切换为本地默认环境，远程设计状态下不支持「更新升级」功能。
3）点击菜单「帮助>更新升级」，查看「立即更新」按钮是否可点击，灰化则说明当前已处于最新版本，无需升级。
3）点击「立即更新」按钮。由于设计器更新时要获取比对 JS 并解析，会出现几秒的延迟，获取更新信息中，请耐心等待。
2.3 重启设计器
1）关闭设计器。
2）如从11.0.9以下版本版本升级至11.0.9及之后版本，请手动删除%FR_HOME%/webapps/webroot/WEB-INF/lib下netty相关jar包。
11.0.9及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能，因此需要删除额外的jar，否则可能无法正常启动工程。
如需从高版本回退至11.0.9以下版本，需要额外在设计器 %FR_HOME%/webapps/webroot/WEB-INF/lib目录下加上netty相关jar包。
点击下载JAR包：netty-all-4.1.78.Final.jar
3）启动设计器。
2.4 检查升级是否成功
重启设计器后，点击菜单「帮助>更新升级」。
提示「当前已是最新版本」，且「立即更新」按钮灰化，说明设计器更新成功。如下图所示：
3. 内网升级/外网升级指定版本
本节方案：FineReport11.0低版本设计器，手动升级到FineReport11.0最新/指定版本
3.1 备份设计器
在进行设计器升级前，为避免升级失败出现文件丢失的情况，请务必对设计器工程进行备份后再升级。
推荐直接备份%FineReport_HOME%\webapps\webroot文件夹。
3.2 获取JAR包
1）如需获取指定版本JAR包，一般都是为了远程连接，可先查看下需要远程连接的服务器工程版本。
登录远程工程，点击「管理系统>注册管理>版本信息」，记录下服务器工程的小版本号（精确到日期）。
2）付费用户请联系帆软技术支持，索要最新/指定版本的JAR包。技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
一般包括 14 个升级 JAR 包：
fine-accumulator-11.0.jar、fine-activator-11.0.jar、fine-core-11.0.jar、fine-datasource-11.0.jar、fine-decision-11.0.jar、fine-decision-report-11.0、fine-report-designer-11.0.jar、fine-report-engine-11.0.jar、fine-schedule-11.0.jar、fine-schedule-report-11.0.jar、fine-swift-log-adaptor-11.0.jar、fine-third-11.0.jar、fine-webui-11.0.jar、fine-cbb-11.0.jar
3.3 手动更新
1）关闭设计器。
2）将fine-report-designer-11.0 JAR 包，放到 %FR_Home%/lib 下。
3）将其余 JAR 包，放到%FR_Home%/webapps/webroot/WEB-INF/lib下。
注：11.0.3 之前版本不存在 fine-cbb-11.0.jar ，只有12个JAR包。如果回退版本，请删除该JAR。
4）如从11.0.9以下版本版本升级至11.0.9及之后版本，请手动删除%FR_HOME%/webapps/webroot/WEB-INF/lib下netty相关jar包。
11.0.9及之后版本，产品内置了netty-all-4.1.78.Final.jar相关功能，因此需要删除额外的jar，否则可能无法正常启动工程。
如需从高版本回退至11.0.9以下版本，需要额外在设计器工程 %FR_HOME%/webapps/webroot/WEB-INF/lib目录下加上netty相关jar包。
点击下载JAR包：netty-all-4.1.78.Final.jar
5）如从11.0.20以下版本升级至11.0.20及之后版本
请先手动删除%FR_HOME%/lib下原有的jxbrowser相关jar包。
请根据设计器所在环境，下载合适的6.0.23和7.26版本的jxbrowser相关jar包，并上传至%FR_HOME%/lib下。
| 环境 | JAR包 | |
|---|---|---|
| Windows | win64 | |
| win32 | ||
| Linux | linux-64 | |
| linux64-arm | ||
| Mac | mac | |
| mac-arm | ||
6）启动设计器。
3.4 检查升级是否成功
重启设计器后，点击菜单「帮助>更新升级」。可查看当前JAR版本，确认是否是自己所需的设计器版本。如下图所示：
4. 注意事项
以下两种场景下，会触发升级。
4.1 插件管理触发升级
设计器开启了「使用新插件管理器」，如下图所示：
点击服务器，插件管理，若检测到 jxbrowser 的 JAR 包不存在，则弹出强制升级提示框，如下图所示：
点击确定或关闭提示框，将跳转至更新升级界面，后续升级步骤如上文所示。
4.2 远程连接版本不一致
服务器上和设计器上的 JAR 的版本要保持一致，否则可能会导致某些模板本地看预览效果正常，服务器下预览出现问题。
当设计器切换工作目录至远程服务器时，若服务器和设计器的 JAR 包不匹配时，将出现弹窗提示。
点击「同步至本地」，将从服务器上获取不一致的内容信息并下载对应jar包和插件并替换本地 JAR 包，替换完成后将重启设计器并再次远程到服务器。如下图所示：
详情请参见：JAR包不匹配常见问题
