FineBI升级指南

编辑
文档创建者:夏娃 (67727 )     浏览次数:10285次     编辑次数:57次     最近更新:doreen0813 于 2018-06-22     

目录:

1、描述编辑

为了完善产品,FineBI的版本一直在不断的升级,用户需要升级时,如何查看产品的版本号呢?进入FineBI安装目录FineBI/webapps/WebReport/WEB-INF/lib,解压fr-bi-server-xx.jar,解压后进入com/finebi目录,打开build.properties文件,查看Version号,如下图,显示版本为4.0.2。若4.0版本,则Main_Version=4;Minor_Version=0;Revision_Version=0;若为4.1版本,Main_Version=4;Minor_Version=1;Revision_Version=0。
222
为满足客户的新需求及之前版本某些功能在使用中的不足之处,我们的产品也在不断更新中。若需要修复之前版本中存在的一些问题及需要使用新的功能,就需要升级到新版本。

2、同版本升级更新编辑

获取jar包有两种方式,一种是联系FineBI的技术人员或在线QQ获取最新jar包,另外一种是在官网下载最新安装包安装后到FineBI/webapps/WebReport/WEB-INF/lib拷贝出需要的7个jar包(4.1版本为十个jar包)。相同版本的FineBI升级只需要更新jar包即可。
同版本更新jar包
联系FineBI技术人员获取jar包:fr-bi-server-4.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(4.1版本为fineio.jar、fr-bi-server-4.1.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、plugin-FineDirect-0.jar的十个jar包),将最新的jar包拷贝到对应目录FineBI/webapps/WebReport/WEB-INF/lib下替换掉原先的jar包,重启FineBI,替换前请注意备份

3、 FineBI4.0.2升级到FineBI4.1编辑

3.1 升级步骤


注:早期的FineBI4.0.2版本需要先升级到最新的402版本,确定没有问题后再按照下面操作升级至4.1版本。最新的4.0.2版本jar包请联系技术支持获取。


1、更新jar包:

联系FineBI技术人员获取4.1版本的jar包:fineio.jar、fr-bi-server-4.1.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-slf4j-frlog4j-1.7.2.25.jar,将十个jar包拷贝到对应目录FineBI/webapps/WebReport/WEB-INF/lib下,并将该目录下原先的fr-bi-server-4.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、guava-18.0.jar、log4j-1.2.17.jar、slf4j-api-1.7.21.jar、slf4j-log4j12-1.7.21.jar这十一个jar包删除,删除前请注意备份。

注:若使用的是jdk1.6版本,需要使用fineio1.5.jar,而不是上面的fineio.jar。


2、新增map文件夹,用来存储4.1新的地图文件。

下载map.zip或者map.tar文件夹,并将解压后的map文件夹放在FineBI/webapps/WebReport/WEB-INF/assets目录下;若用户之前使用过自定义图片地图,需要将前面assets目录下的geojson/image文件夹移动到assets/map/imgae下。


3、地图gis图层资源新增,新增mapLayer.xml文件,需要拷贝至FineBI/webapps/WebReport/WEB-INF/resources目录下:

maylayer.xml


4、兼容问题:4.1之前点地图,如果采用经纬度设置,需要的数据结构为经度纬度放在同一个字段中,如‘经度,纬度’。与大部分用户的数据库结构并不符,且不易理解。4.1中要以经纬度定位点时,数据要求有两个字段,分别为‘经度’和'纬度'。


5、新增配置文件。FineBI/webapps/WebReport/WEB-INF/resources目录下增加系统参数配置xml文件:

systemconfig.xmlplugs.properties


6、FineBI/webapps/WebReport/WEB-INF/lib目录下的日志输出文件FineLog.properties需要替换:

FineLog.properties


7、插件管理:下载文件scripts.zip或者scripts.rar,解压后将文件夹内的文件(scripts文件夹和plugin.html)放到WebReport目录下。

222

对于FineBI的插件,需要将原先4.0.2版本中FineBI/webapps/WebReport/WEB-INF/lib下插件对应jar包和FineBI/webapps/WebReport/WEB-INF/plugins目录下插件对应文件夹都删除(包括FineDirect引擎插件),如下图,并在升级成功后去插件商城下载新版本安装使用;

222
222
对于FineReport的插件,无需操作处理,在升级成功后若发现有插件不能用,可直接在插件商城下载新的版本安装即可;


8、模板管理节点(原所有模板):在完成插件管理的基础上,安装新的插件包:fr-plugin-bi-report-manager-1.1.zip


9、删除FineBI/webapps/WebReport/WEB-INF/assis目录下的phantom文件夹。


10、修改FineBI/webapps/WebReport/WEB-INF/resources目录下的config.xml文件,删除下图红框中的几行内容。

11、若客户工程在402是FR+BI的形式,需要把FineBI/webapps/WebReport/WEB-INF/resources目录下的phantom文件夹放到assist下面。


12、若使用了FineDirect引擎,参考下面2.3节,需要将原先FineBI/webapps/WebReport/WEB-INF/lib文件夹下的plugin-FineDirect-0.jar替换为4.1版本(jar包可同样联系技术支持获取),且需将原先的FineDirect插件在FineBI/webapps/WebReport/WEB-INF/plugins中删除


13、确认402中是否开了用户同步数据集,如果开启了用户同步数据集,需要将用户信息迁移到平台数据库再升级。可参考

同步数据集迁移至平台数据库4.4章节迁回。


14、所有文件替换完毕后,启动工程,FineBI/webapps/WebReport/bakup会自动备份升级前的WebReport下所有文件;启动过程中,会提示需要重启,若启动完成打开了浏览器,浏览器也会提示重启,因FR需要兼容操作,正常重启FineBI服务器即可。

注:1、以上提供目录均为FineBI直接安装的工程目录,若BI部署在web服务器中,则需到对应web服务器目录中找到相应地址,例如tomcat下为Tomcat 7.0\webapps\WebReport\WEB-INF\lib。   
2、若为部署环境更换了JRE的话,则在上述升级步骤中还需要下载bilistener文件并替换到FineBI/lib文件夹以后才能启动工程。
3、在4.1版本中FineDirect引擎已与FineIndex引擎做了充分的融合,不再以插件的形式存在。因此在升级的时候原FineDirect插件需要在plugins目录中删除,如上述第13点直接拷贝4.1版本的FineDirect jar包即可。  
4、升级后第一次启动有兼容操作,客户工程内容较多会比较慢,需耐心等待。平台用户较多的情况,升级后每次启动都会比较慢,4k用户启动时间大概10min,用户越多启动时间会呈指数级增长。

3.2 升级兼容性
在FineBI4.0.2升级到4.1以后,有些在4.0.2版本中使用的功能是不兼容的,需要在升级后的系统中进行手动重新设置,具体包括下述功能点:
1、仪表板指标下拉选项样式设置中的内容在升级后需要重新设置;
222

2、组件属性设置中的纵向网格线在4.0.2版本中勾选显示,但升级后在4.1版本中会被取消勾选,需要重新勾选。
222

3、
数据配置>多路径设置中的路径在升级后需要重新勾选设置。
222

4、FineBI4.0升级到FineBI4.0.2编辑

1、将4.0版本FineBI/webapps/WebReport/WEB-INF/lib目录下七个jar包删除:fr-bi-server-4.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,然后将从技术支持处获取的4.0.2七个jar包放入到此目录中(此时千万不能直接重启,且删除jar包前注意备份);

2、将FineBI/webapps/WebReport/WEB-INF/resources目录下的excel_data和geojson文件夹移到父目录下的assets文件夹下(复制粘贴过去即可,不要剪切会影响部分FineReport用到的图表);删除FineBI/webapps/WebReport/WEB-INF/resources下的images文件夹,在此处下载images文件夹并将其放入FineBI/webapps/WebReport/WEB-INF/assets目录下
222

3、FineBI/webapps/WebReport/WEB-INF/resources目录下的chartPreStyle.xml文件需要更新,在此处下载后放入该文件夹替换即可;
222

4、FineBI/webapps/WebReport/WEB-INF/assist目录下的phantom文件夹需要更新,对应全局导出功能,根据所用服务器操作系统在此处下载对应的文件放入;
222

5、FineBI/webapps/WebReport/WEB-INF/resources目录下的config.xml文件需要在最后增加几行内容;
222

增加内容如下图所示:
222
<Flexible> <PhantomPath>/assist/phantom</PhantomPath> <BIPhantomTimeout>10000</BIPhantomTimeout> <BIPhantomMainPort>60810</BIPhantomMainPort> <BIPhantomSubPort>60815</BIPhantomSubPort> </Flexible>
6、FineBI/webapps/WebReport/WEB-INF/resources目录下有以下两个文件夹在4.0.2版本中用不到了,可以删掉;
222

7、4.0.2版本中分级权限控制功能中的所有模板是以插件形式安装的,402安装包中自带,4.0升级需要安装该插件。下载bi-plugin-allreport-1.0.zip插件,并参考插件管理安装;

8、下载bilistener文件替换掉FineBI/lib下的该文件;将4.0.2版本中的FineBI/conf文件夹替换掉4.0中的该文件夹所有内容;从安装包中获取并替换掉FineBI/目录下的启动文件FineBI;

9、在FineBI/webapps/WebReport/WEB-INF/lib目录下添加日志文件FineLog.properties,在此处下载并放入;

10、将FineBI/webapps/WebReport/WEB-INF/resources目录下的biReport文件夹手动迁移到FineBI/webapps/WebReport/WEB-INF下。若已经在两个目录下都有了biReport文件夹,那就把resources目录下不同文件夹的.fbi文件分别迁移到WEB-INF内相同文件夹名下。这时候若碰到重名的情况,选择不覆盖就可以

11、以上步骤全部完成后,重启FineBI服务器,重启之后服务器会自动完成兼容和升级。

5、FineDirect升级更新编辑

FineDirect的升级同样需要联系技术人员获取jar包:plugin-FineDirect-0.jar,将jar包拷贝到FineBI/webapps/WebReport/WEB-INF/lib中替换,替换前请注意备份。
222
FineBI旧版本如何升级到FineDirect可参考FineBI旧版本升级

6、升级注意事项编辑

6.1 更新jar包前必须备份
FineBI采用向下兼容方式,即高版本兼容低版本。在升级至高版本时,为防止升级后出现兼容问题,升级前请备份原jar包及配置文件等,最好将整个WebReport工程都进行备份,如果FineIndex文件太大,可以将FineIndex删除之后,然后再将工程备份。
注:只要数据连接成功,FineIndex可以根据配置文件重新生成。       
升级后存放jar包的文件夹下不能存在老版本的jar包(重命名的也不可以),否则读取的还是老版本的jar包。
6.2 升级版本范围
FineBI报表提倡小版本间升级,即如版本4.0升级至4.0.2版本,升级时最好先将FineIndex删除,然后换jar包重新生成FineIndex文件。
不建议跨大版本升级,如果需要,必须小版本间层层升级,如有类似情况,请先咨询FineBI技术人员。

附件列表


主题: 快速入门
标签: 暂无标签 编辑/添加标签
如果您认为本文档还有待完善,请编辑

文档内容仅供参考,如果你需要获取更多帮助,请咨询帆软技术支持
关于技术问题,您还可以通过帆软论坛获取帮助,论坛上有非常多的大神,有些水平比帆软工程师还要高哦。
若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

本文档是否有用?