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

目录:

1 描述编辑

为满足客户的新需求及完善之前版本某些功能在使用中的不足之处,我们的产品也在不断更新中。若需要修复之前版本中存在的一些问题及需要使用新的功能,就得需要您升级到新版本。

此次升级到9.0新增一键升级功能,升级更为方便,分为设计器升级和服务器升级,下面详细介绍一下从8.0升级到9.0的方法。

2 FineReport8.0版本升级9.0编辑

2.1 设计器升级

2.1.1 安装设计器更新升级插件

设计器只支持通过更新升级插件从8.0升级至9.0,所以必须安装设计器更新升级插件设计器插件安装方法参照设计器插件管理

打开设计器,点击菜单帮助>更新升级,会在该界面显示“新版FineReport9.0已上线!立即更新升级”,如下:

2.1.2 自动更新升级

(1)点击立即升级,弹出框可查看9.0版本特性和兼容性说明:

(2)确认完毕后,若点击右下角“取消”则为放弃升级点击“兼容并升级”即进入自动升级步骤并弹出框显示升级进度

首先会自动备份8.0工程,做兼容处理后再下载最新9.0jar包:


注:9.0在%FR_Home%/lib下新增一jar包,aspectjrt.jar,用来监听用户直接操作菜单的,必要时弹出alphafine广告; 在%FR_Home%/WebReport/WEB-INF/lib下新增一jar包,fr-datasource-9.0.jar,用于数据库连接时和所有不同数据库的适配,包含jdbc的连接池。

(3)进行到最后一步完成后,自动弹出升级成功界面并可选择是否立即重启打开9.0设计器:

点击立即重启即可。

2.1.3文件存储说明

a.新建文件夹desginerbakup文件夹,用于区分原工程的bakup

b.如果是8.0升级至9.0,则将原FineReport文件夹全都压缩到FineReport/designerbakup文件夹下的8.0desginerbakup压缩包内,不提供功能直接还原,如果需要还原,则将zip包解压后即可。

222

注:如果是mac系统,还需要将解压后install4j下面的jrebundle.tar解压下来的jre.bundle替换原有的,如下图:

222

c.如果是9.0更新升级,则新的存储位置在FineReport/designerbakup

d.原先bakup和bakupversion文件夹被删除

2.1.4 9.0设计器更新升级

9.0小版本的更新升级可通过替换jar包实现,向FineReport技术人员索要单独的升级包fr-designer-report-9.0.jar、fr-designer-core-9.0.jar、fr-designer-chart-9.0.jar,将这三个jar包替换到%FR_Home%/lib下;以及fr-chart-9.0.jar、fr-core-9.0.jar、fr-datasource-9.0.jar、fr-performance-9.0.jar、fr-platform-9.0.jar、fr-report-9.0.jar、fr-third-9.0.jar(共七个jar包),将这七个jar包替换到%FR_Home%/WebReport/WEB-INF/lib下。

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

2.2 服务器更新升级

服务器的升级有两种方法,分别如下:
方法一: 更新jar包
拷贝已经升级好的9.0设计器jar包或者向FineReport技术人员索要单独的升级包fr-chart-9.0.jar、fr-core-9.0.jar、fr-datasource-9.0.jar、fr-performance-9.0.jar、fr-platform-9.0.jar、fr-report-9.0.jar、fr-third-9.0.jar(共七个jar包),将这七个jar包放到%Tomcat_Home%/webapps/appname/WEB-INF/lib下,还有fr-applet-9.0.jar,放到%Tomcat_Home%/webapps/appname下,将原来的fr-xx-8.0.jar删除。
替换jar之后首次启动,会进行兼容操作,要求重启一次服务器。注意关闭tomcat需要用shutdown脚本进行正常关闭,否则无法触发后续的任务。
方法二: 通过决策平台插件管理升级
(1)登录决策平台,在管理系统>插件管理搜索“决策平台升级更新”插件进行安装
服务器安装插件方法参照服务器插件管理
(2)打开管理系统>系统管理>更新升级,可看到“新版FineReport9.0已上线!立即更新升级”,如下:
点击立即升级,步骤和设计器更新升级相同,最后重启服务器即可。
(3)注:升级到9.0后,“决策平台升级更新”插件所处目录变更,变更为管理系统>智能运维>备份还原>更新升级如下:
222
文件存储说明

a.如果是8.0升级至9.0,则将原WebReport的文件夹全都压缩到WebReport/bakup文件夹下的“8.0projectbakup.zip”压缩包内,不提供功能直接还原,如果需要还原,则将zip包解压后替换即可。

注:手动换jar包,备份的8.0工程,里面的jar包是9.0的jar,所以还原的时候还要手动换成8.0的jar

b.如果是9.0更新升级,则新的存储位置在WebReport/bakup文件夹内的update_bakup里。

c.原先frbak文件夹被删除。


3 FineReport9.0小版本升级
3.1 设计器升级
3.1.1 在线更新jar包
打开设计器,点击菜单帮助>更新升级,在最新JAR一栏会出现新版本号,下方会有更新按钮,如下图:

222

按照提示更新,下方显示下载jar包进度
222

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

重启之后最新JAR一栏显示为“已经是最新版本”,即完成小版本更新。

3.1.2 人工更新jar包
向FineReport技术人员索要单独的升级包fr-designer-report-9.0.jar、fr-designer-core-9.0.jar、fr-designer-chart-9.0.jar、fr-chart-9.0.jar、fr-core-9.0.jar、fr-datasource-9.0.jar、fr-performance-9.0.jar、fr-platform-9.0.jar、fr-report-9.0.jar、fr-third-9.0.jar、fr-applet-9.0.jar(共11个jar包)。将fr-xx-9.0.jar拷贝到对应目录。

具体步骤:
1.  fr-designer-report-9.0.jar、fr-designer-core-9.0.jar、fr-designer-chart-9.0.jar:这三个jar包包含FineReport设计器的所有功能,必须更新,存放在%FR_Home%/lib下;
222
2.  fr-applet-9.0.jar:Applet打印所使用的包,若需要进行Applet打印,则存放在服务器报表工程如%FR_Home%/WebReport下;
222
3.  fr-third-9.0.jar、fr-chart-9.0.jar、fr-core-9.0.jar、fr-performance-9.0.jar、fr-platform-9.0.jar、fr-report-9.0.jar、fr-datasource-9.0.jar:升级到9.0小版本的时候,需要将这七个jar包放 到%FR_Home%/WebReport/WEB-INF/lib下;
222
  注:更新jar包后需要重启设计器才会生效,而且jar包所放位置不能放错,否则会导致不能打开设计器。
3.2 设计器升级
3.2.1 更新jar包
向FineReport技术人员索要单独的升级包fr-chart-9.0.jar、fr-core-9.0.jar、fr-datasource-9.0.jar、fr-performance-9.0.jar、fr-platform-9.0.jar、fr-report-9.0.jar、fr-third-9.0.jar、fr-applet-9.0.jar(共八个jar包),将fr-xx-9.0.jar拷贝到对应目录:
具体步骤:
1. fr-applet-9.0.jar:Applet打印所使用的包,若需要进行Applet打印,则存放在服务器报表工程如%Tomcat_Home%/webapps/WebReport下。
2. fr-chart-9.0.jar、fr-core-9.0.jar、fr-performance-9.0.jar、fr-platform-9.0.jar、fr-report-9.0.jar、fr-third-9.0.jar、fr-datasource-9.0.jar:升级到9.0小版本的时候,需要将这七个jar包放到%Tomcat_Home%/webapps/WebReport/WEB-INF/lib下;其中fr-third-9.0.jar包含了引用的第三方类。
3.2.2 安装设计器后拷贝jar包
安装最新版本设计器,然后拷贝安装目录下其位置处的包替换要升级服务器下的包,即可进行升级。
注:更新jar包后需要重启服务器如Tomcat才会生效。并且需要保证服务器上和设计器上的jar的版本一致,否则可能会导致某些模板在本地看的效果是正确的,但是放在服务器下面的时候就出问题了。
另:在进行版本升级时请先查看升级兼容性,有的版本升级时的方式可能会有所差异,大体不变。
3.2.3 通过决策平台插件管理升级
(1)登录决策平台,在管理系统>插件管理,搜索“平台升级”插件进行安装
222
(2)管理系统>智能运维>备份还原>更新升级点击立刻更新按钮,等待更新jar,成功后重启服务器即可
222

4 FineReport9.0版本升级10.0编辑

为了帮助用户更顺利的从9.0升级到10.0版本,我们特提供一个独立的辅助升级程序,可以将9.0的web工程升级到10.0工程,包括jar包、各类配置文件、finedb数据表等的兼容升级。
该辅助升级工具无需安装,即点即用,简单方便。具体可参考9-10升级工具