FineBI升级指南

1、描述
2、同版本升级更新
3、 FineBI4.0.2升级到FineBI4.1
5、FineDirect升级更新
6、升级注意事项

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。

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

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，替换前请注意备份。

1.从2019年1月18号及之前的jar升级到此后的jar版本时，如果出现excel表预览只有表头，更新报错有关键字nullpoint时，要在%FineBI%\webapps\WebReport\WEB-INF\resources 目录下，编辑plugs.properties文件，新增参数：performance.isDirectIndexing =true；

2.从2019年1月18号及之前的jar升级到2019年4月3号之后的jar后，需要进行全局更新操作；或者在%FineBI%\webapps\WebReport\WEB-INF\resources 目录下，编辑plugs.properties文件，新增参数：performance.isDirectIndexing =true；

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.xml、plugs.properties

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

7、插件管理：下载文件scripts.zip或者scripts.rar，解压后将文件夹内的文件（scripts文件夹和plugin.html）放到WebReport目录下。
对于FineBI的插件，需要将原先4.0.2版本中FineBI/webapps/WebReport/WEB-INF/lib下插件对应jar包和FineBI/webapps/WebReport/WEB-INF/plugins目录下插件对应文件夹都删除（包括FineDirect引擎插件），如下图，并在升级成功后去插件商城下载新版本安装使用；

插件商城下载新的版本安装即可；

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，用户越多启动时间会呈指数级增长。

5、若4.0.2版本的权限配置设置了部门职位权限，且业务包权限设置了“所有部门所有职务”，在升级4.1时，使用Linux英文环境升级会出现权限异常，需要切换成Linux中文环境再升级。

3.2 升级兼容性

在FineBI4.0.2升级到4.1以后，有些在4.0.2版本中使用的功能是不兼容的，需要在升级后的系统中进行手动重新设置，具体包括下述功能点：

1、仪表板指标下拉选项样式设置中的内容在升级后需要重新设置；

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

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

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目录下；

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

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

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

增加内容如下图所示：

<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版本中用不到了，可以删掉；

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中替换，替换前请注意备份。

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技术人员。

主题：

标签：暂无标签