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

下面详细介绍下如何进行版本的升级。

注：FineBI4.1版本升级至5.1版本的操作可参考4.1-5.1升级指南。

2019 年 8 月 16 日之前安装的 4.1 及 5.1 版本 FineBI ，由于内置地图文件版本较老，需要手动更新，请参考地图文件更新操作。

FineBI同版本之间升级的时候只需要更新jar包就行了，获取jar包有两种方式：一种是联系FineBI的技术人员或在线QQ获取最新jar包，另外一种是在官网下载对应版本安装包安装后，到%FineBI%/webapps/webroot/WEB-INF/lib下拷贝出需要的jar包。

2.1 5.0同版本升级

联系FineBI技术人员获取5.0jar包：fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-bi-adapter-5.0.jar、fine-bi-engine-spider-5.0.jar、fine-bi-engine-third-5.0.jar、fine-bi-foundation-5.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-bi-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-bi-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar，将jar包拷贝到对应目录%FineBI%/webapps/webroot/WEB-INF/lib下替换掉原先的jar包，如下图：

替换前请注意备份原jar包，替换完成后重启FineBI即可。

注：若为从9.15的stable安装包升级到之后版本，除了更新以上jar包外，还需要更换%FineBI%/lib下面的fine-bi-starter.jar；linux安装版本，需要直接更换FineBI目录下的jre：jre.tar.gz；

使用tomcat、weblogic等容器部署的，从9.15的stable升级到之后版本，需要将环境上安装的jdk的lib下面的tools.jar拷贝到Tomcat_home/lib或%FineBI%/webapps/webroot/WEB-INF/lib任一位置。

2.2 5.1同版本升级

获取5.1升级jar包：fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-bi-adapter-5.1.jar、fine-bi-datamine-5.1.jar、fine-bi-datamine-third-5.1.jar、fine-bi-engine-spider-5.1.jar、fine-bi-engine-third-5.1.jar、fine-bi-foundation-5.1.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-bi-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-bi-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar，将jar包拷贝到对应目录%FineBI%/webapps/webroot/WEB-INF/lib下替换掉原先的jar包（替换前请注意备份），如下图：

替换完成后重启FineBI即可。

3.1 升级步骤

FineBI5.0升级到5.1相比同版本之间步骤多，下面我们介绍详细的升级步骤（升级前关闭FineBI）：

1. 进入目录%FineBI%/webapps/webroot/WEB-INF/lib，删除fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-bi-adapter-5.0.jar、fine-bi-engine-spider-5.0.jar、fine-bi-engine-third-5.0.jar、fine-bi-foundation-5.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-bi-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-bi-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar、REngine.jar、Rserve.jar、timeseriesForecasting-1.1.27.jar、weka.jar共22个jar文件（删除前注意备份）。将获取的5.1jar拷贝至该目录，拷贝后的文件夹如下图：

2. 下载ehcache.db.properties文件，并将其放入%FineBI%/webapps/webroot/WEB-INF/config目录下（若没有config文件夹则新建），如下图：

3. 备份%FineBI%/webapps/webroot/WEB-INF/embed下的finedb文件夹，若之前做过数据迁移，则在对应数据库下做备份；

4. 若为Windows或者Mac OS系统下部署的安装版FineBI，则需下载fine-bi-starter.jar，将其替换至%FineBI%/lib下（替换前注意备份原文件）；

5. 若为exe安装的FineBI5.0，且使用了phoenix的驱动，则需要在%FineBI%/webapps/webroot/WEB-INF/lib下找到驱动包phoenix-4.12.0-HBase-1.2-client.jar，并将里面的javax.servlet这个文件夹删除。否则由于冲突工程会启动不了；

分布式增加的步骤：

6. 若为Spider分布式部署用户，在升级时还需要对集群的配置进行更改，需要给spark集群服务添加参数spark.shuffle.service.enabled并设置为true，否则BI启动的时候会报错导致无法启动。参数添加步骤如下：

      a）打开ambari的页面，选中Spark服务的标签，并且选中Configs标签栏，如图所示：

      b）展开Custom spark2-defaults标签项，点击Add Property按钮，添加如下内容：spark.shuffle.service.enabled=true ，如图所示：

      c）添加完成，点击Add按钮，然后重启spark服务即可；

7. 以上升级步骤完成后，重启FineBI即可完成升级5.1。

3.2 注意事项

1. 5.1取消联动分组功能，5.0升级到5.1后，会依据5.0配置的联动分组给组件配置联动方向；

2. 5.1的水印功能不支持IE11以下的浏览器，IE11以下浏览器虽然也有水印，但是面板上什么都操作不了；且该水印功能对定时调度相关文件和数据无效；

3. 将BI从5.0升级到5.1及以上的版本时，参考使用第三方管理软件连接报表内置HSQL数据库FineDB连接finedb数据库，查看finebi内置的数据库中表fine_conf_entity下是否有DistributedOptimizationConfig.spiderConfig.spider_namenode_mode字段。若有该字段，则需将该字段下的value值改为auto;若无该字段，则需要增加该字段并将其value值设置为auto。

4.1 升级步骤

注：若为5.0升级至5.1 2019.7版本，需要先将5.0升级至5.1版本，再按照如下步骤升级至2019.7月版本。

1. 获取2019.7 5.1的jar包，拷贝至FineBI目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的jar包；

   注：换jar前请备份工程webroot（配置了外接数据库同时备份平台配置）。

2. 若为Windows或Mac系统，需要更新启动器文件。

   Windows：lib-win64.zip

   Mac：lib-mac.zip

   在此处下载对应操作系统的文件，解压后将其中的jar包拷贝至FineBI目录%FineBI%/lib下，替换原先的jar；

4.2 注意事项

1.  升级后，原普通BI设计用户默认兼容为数据分析用户，管理员为数据处理用户。若原BI设计用户想要在升级后仍然从数据库添加基础表到业务包中，需要在升级后将其改为数据处理用户，参考BI设计用户；

2. 升级后，所有自助数据集都会兼容为数据处理自助数据集，计算无数据量限制，并且可以手动配置关联和权限。建议此前存在更新慢的用户，升级之后重新梳理关联关系，删除不需要的表间关联；

3. 5.1升级到5.1 2019.7版本，sqlite数据连接创建的sql数据集会更新失败，需要编辑预览之后，再更新才能成功。比如：内置demo中业务包>高级报表>订单明细表；

4. 若原仪表板非热力点类型的图表采用了热力色方案，且使用了'自动'颜色分配，则有可能导致部分图形渲染为白色，从而导致在白色背景下无法辨识，需更换颜色；

5. 定时调度附件选择pdf，组件配色与原模板配色不一致，且地图组件可能doa该问题在后续版本将解决；

6. 使用IE11浏览器设置地图配置中的自定义图片，保存无效，该问题在后续版本将解决；

7. 图表组件中设置警戒线后，修改指标显示名，警戒线显示错误，在换jar后，需要手动调整；

8. 来自不同数据连接之间的实时数据表若关联，会产生内存计算，性能较差，且会有数据量限制。建议这种场景，都设置为抽取数据并关联；

9. 自助数据集选择的字段若同时来自于实时数据和抽取数据的表，或者来自不同数据连接的实时数据表，同样性能较差，且会有数据量限制。建议这种场景，原数据表均设置为抽取数据处理；

10. 数据处理用户若为实时数据自助数据集配置和任意表的关联，性能和数据量都会存在限制。建议数据处理用户仅配置实时数据基础表的关联，需要进行数据处理的优先在SQL中处理；

11. 在升级之前，若工程做了数据库迁移，请检查迁移数据库的编码与表fine_conf_entity的编码是否一致，若不一致，先将数据库的编码修改为与fine_conf_entity一致。