历史版本24 :小版本升级指南 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 描述编辑

为满足客户的新需求及完善之前版本某些功能在使用中的不足之处,我们的产品也在不断更新中。若需要修复之前版本中存在的一些问题及需要使用新的功能,就得需要您升级到新版本。那么在需要升级时,如何查看产品的版本号呢?详细请查阅FineReport版本说明
升级分为设计器升级和服务器升级,其升级方式分为重新安装设计器和更新jar包,以下分别介绍。

2. 8.0设计器的升级编辑

2.1 安装设计器
设计器可从官方网站下载最新版本,重新安装即可。不同版本的设计器,可在一台机器上同时安装,且互不影响。
注:官网发布的版本为经过回归测试后的稳定版本,每隔一段时间进行一次更新,所以官网的设计器并非最新版,而是最新稳定版。同时帆软提供了更新升级插件,使用该插件可以每天进行一次更新,详见2.3在线更新jar包。
2.2 人工更新jar包
向FineReport技术人员索要单独的升级包fr-designer-report-8.0.jar、fr-designer-core-8.0.jar、fr-designer-feedback-8.0.jar、fr-designer-chart-8.0.jar、fr-chart-8.0.jar、fr-core-8.0.jar、fr-performance-8.0.jar、fr-platform-8.0.jar、fr-report-8.0.jar、fr-third-8.0.jar、fr-applet-8.0.jar(共11个jar包)。将原来的fr-xx-8.0.jar删除,然后将fr-xx-8.0.jar拷贝到对应目录。
具体步骤:
1.  fr-designer-report-8.0.jar、fr-designer-core-8.0.jar、fr-designer-feedback-8.0.jar、fr-designer-chart-8.0.jar:这四个jar包包含FineReport设计器的所有功能,必须更新,存放在%FR_Home%/lib下;
222

2.  fr-applet-8.0.jar:Applet打印所使用的包,若需要进行Applet打印,则存放在服务器报表工程如%FR_Home%/WebReport下;
222

3.  fr-third-8.0.jar、fr-chart-8.0.jar、fr-core-8.0.jar、fr-performance-8.0.jar、fr-platform-8.0.jar、fr-report-8.0.jar:升级到8.0的时候,需要将这六个jar包放 到%FR_Home%/WebReport/WEB-INF/lib下;
222

注:更新jar包后需要重启设计器才会生效,而且jar包所放位置不能放错,否则会导致不能打开设计器。
2.3 在线更新jar包
1、菜单服务器>插件管理,搜索“更新升级”插件进行安装
222

2、安装完更新升级插件后重启,点击菜单帮助>更新升级,按提示进行升级即可
222

3. 8.0服务器的升级编辑

服务器的升级有四种方法,分别如下:
3.1 更新jar包
向FineReport技术人员索要单独的升级包fr-chart-8.0.jar、fr-core-8.0.jar、fr-performance-8.0.jar、fr-platform-8.0.jar、fr-report-8.0.jar、fr-third-8.0.jar、fr-applet-8.0.jar(共七个jar包),将原来的fr-xx-7.0.jar删除,然后将fr-xx-8.0.jar拷贝到对应目录:
具体步骤:
1. fr-applet-8.0.jar:Applet打印所使用的包,若需要进行Applet打印,则存放在服务器报表工程如%Tomcat_Home%/webapps/appname下。
2. fr-chart-8.0.jar、fr-core-8.0.jar、fr-performance-8.0.jar、fr-platform-8.0.jar、fr-report-8.0.jar、fr-third-8.0.jar:升级到8.0的时候,需要将这六个jar包放到%Tomcat_Home%/webapps/appname/WEB-INF/lib下;其中fr-third-8.0.jar包含了引用的第三方类。
3.2 安装设计器后拷贝jar包
安装最新版本设计器,然后拷贝安装目录下其位置处的包替换要升级服务器下的包,即可进行升级。
注:更新jar包后需要重启服务器如Tomcat才会生效。并且需要保证服务器上和设计器上的jar的版本一致,否则可能会导致某些模板在本地看的效果是正确的,但是放在服务器下面的时候就出问题了。
另:在进行版本升级时请先查看升级兼容性,有的版本升级时的方式可能会有所差异,大体不变。
3.3 通过决策平台插件管理升级
1、登录决策平台,在管理系统>插件管理,搜索“平台升级”插件进行安装
222
注:第一步安装平台插件后,无法在系统管理模块中看到更新升级页签,可做以下操作。
在chrome浏览器点击更多工具>开发者模式,在network页签中勾选关闭缓存。其他浏览器操作类似。
222
2、在管理系统>系统管理>更新升级点击立刻更新按钮,等待更新jar,成功后重启服务器即可

222

3.4 通过安装兼容插件的方法升级

(1)将7.1的工程拷贝到tomcat安装目录下的webapps文件夹下,如图:

222

注:该文档默认报表工程是WebReport,如实际报表工程不是WebReport,以实际报表工程为准,路径都是一样的

操作完后,启动tomcat,登陆http://ip:端口号/WebReport/ReportServer?op=fs访问决策平台,看到登陆界面就表示部署成功。

然后本地安装一个8.0的设计器,安装在一个全新的目录。

(2)备份拷贝jar包

备份的jar包:

WebReport目录下的fr-applet-7.1.jar;WEB-INF/lib文件夹下的fr-server-7.1.jar和fr-third-7.1.jar

拷贝的新jar包:

fr-third-8.0.jar、fr-chart-8.0.jar、fr-core-8.0.jar、fr-performance-8.0.jar、fr-platform-8.0.jar、fr-report-8.0.jar:从本地安装目录WebReport/WEB-INF/lib下拷贝到tomcat的WebReport/WEB-INF/lib下;

fr-applet-8.0.jar:从本地安装目录 /WebReport下拷贝到tomcat的/WebReport下;

全部拷贝完成后,重启tomcat,登陆决策平台,看到的就会是8.0的决策平台,说明升级成功。

(3)本地安装兼容插件

打开设计器,选择服务器>插件管理
222
选中711升级8.0平台兼容插件,点击安装:

222

进度条加载完毕会弹出一个警告框,请选择重启设计器,重启完毕后,插件安装完成并启用。
222

(4)服务器安装兼容插件

将本地WEB-INF/lib文件夹下的一个jar包:plugin-com.fr.plugin.fscompatible-0.jar拷贝到tomcat的报表工程的WEB-INF/lib文件夹中

将本地WEB-INF/plugins文件夹下的一个文件夹:plugin-com.fr.plugin.fscompatible拷贝到tomcat的报表工程的WEB-INF/plugins文件夹中

重启tomcat,登陆决策平台查看之前开启的“用户同步数据集”和权限管理部分,可以看到已全部兼容升级到8.0

222
222
(5)测试模板

将7.1所做的所有模板全部放到8.0 的工程下,即从原来的reportlets文件夹下将模板拷贝到8.0安装目录的reportlets下,并将原来WEB-INF/resources文件夹下的datasource.xml文件拷贝到8.0安装目录的WEB-INF/resources文件夹下,datasource.xml文件存放的是数据连接信息,替换完后需要重启8.0的设计器。

当所有模板测试完毕没,有问题之后,将这些模板全部拷贝到tomcat的报表工程的WEB-INF/reportlets文件夹下,重启tomcat即可。

4. 升级注意事项编辑

4.1 更新jar包前必须备份
FineReport采用向下兼容方式,即高版本兼容低版本。在升级至高版本时,为防止升级后出现兼容问题,升级前请备份原jar包及模板。
注:升级后存放jar包的文件夹下必须将旧的jar包移除,否则读取的还是旧版本的jar包。
4.2 升级版本范围
FineReport报表提倡同版本间升级,即如6.5.1版本升级至6.5.5版本。
不建议跨版本升级,如6.1或6.2升级到6.5或者7.0版本,如有类似升级情况,请先咨询FineReport技术人员。