1. 描述编辑
为满足客户的新需求及完善之前版本某些功能在使用中的不足之处，产品也在不断更新中。若需要修复之前版本中存在的一些问题及需要使用新的功能，就需要升级到新版本。
本文详细介绍如何进行版本的升级。
注：FineBI4.1 版本升级至 5.1 版本的操作可参考 4.1-5.1升级指南 。
2019 年 8 月 16 日之前安装/升级的 4.1 及 5.1 版本 FineBI ，由于内置地图文件版本较老，需要手动更新，请参考 地图文件更新 操作。
2. 同版本升级编辑
FineBI 同版本之间升级的时候只需要更新 JAR 包即可，获取 JAR 包有两种方式：一种是联系 FineBI 的技术人员或在线 QQ 获取最新 JAR 包，另外一种是在官网下载对应版本安装包安装后，到%FineBI%/webapps/webroot/WEB-INF/lib下拷贝出需要的 JAR 包。
2.1 5.0 同版本升级
联系 FineBI 技术人员获取 5.0 JAR 包：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. 5.0 升级 5.1编辑
3.1 升级步骤
3.1.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.1 JAR 拷贝至该目录，拷贝后的文件夹如下图所示：
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 这个文件夹删除。否则由于冲突工程会无法启动。
3.1.2 分布式步骤
除上述步骤之外，分布式部署还需增加步骤如下：
若为 Spider 分布式部署用户，在升级时还需要对集群的配置进行更改，需要给 spark 集群服务添加参数spark.shuffle.service.enabled 并设置为 true ，否则 BI 启动的时候会报错导致无法启动。参数添加步骤如下：
1）打开 ambari 的页面，选中 Spark 服务的标签，并且选中 Configs 标签栏，如图所示：
2）展开 Custom spark2-defaults 标签项，点击 Add Property 按钮，添加如下内容：spark.shuffle.service.enabled=true ，如图所示：
3）添加完成，点击Add按钮，然后重启spark服务即可；
以上升级步骤完成后，重启 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. 5.1 升级 2019.7 5.1 版本编辑
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 ；
3）若使用 Linux 系统，且需使用大数据量的图表展示，则需判断是否需要升级系统 GCC ，参考 图表大数据GCC升级 。
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 一致。
5. 5.1 升级 2020.1 发布的 5.1 版本编辑
5.1 升级前注意事项
1）升级前提：5.1 升级到 2020.1 发布的 5.1 版本必须先升级到 2019.7 版本，然后再升级到 2020.1 版本。
注：换 JAR 前请备份工程 webroot（配置了外接数据库同时备份平台配置）。
2）若用户在升级前的 BI 中使用过数据挖掘功能，那么在升级之前需要把 BI 里面数据挖掘相关的表删掉，再替换 JAR 包，并删掉原来%FineBI%/webapps/webroot/WEB-INF/lib下的 fine-bi-datamine-5.1.jar、fine-bi-datamine-third-5.1.jar 的两个包。
3）exe 安装检查项：请检查安装版本是否为 5.1 版本，若是则需替换%FineBI%/lib下的三个 JAR 包为新的，否则没有后台控制台显示，如下图所示：
5.2 升级步骤
5.1升级至 2020.1版本
获取 2020.1 5.1 的 JAR 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包；
2019.7 版本升级至 2020.1 版本
获取 2020.1 5.1 的 JAR 包，拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中，替换原先的 JAR 包；
5.3 注意事项
5.1 升级至 2020.1 版本
1）需要确保升级前后的环境工程 JVM 参数中 国际化 设置一致。如果升级前后的 JVM 参数变化导致升级前后的国际化环境不同，可能会导致 Excel 数据集中空白字段读取错误。
2）升级后分类轴在纵向时，默认设置为右对齐。
3）升级后原仪表板的配色方案如果是非自动（例如：彩虹），那么升级后维度与颜色匹配关系仍然保留，只是顺序改变。
4）5.1 的大数据展示没有限定展示的数据量，升级后，依据限定的数据量展示。如下所示：
雷达图：分组数据小于 1k 不触发大数据模式；分组数据属于(1k，5k）,触发大数据模式，展示实际分组数据；分组数据大于 5k ，触发大数据模式，限定分组数据 5k ；
饼图、漏斗图、矩形块、力学气泡图、多层饼图：小于等于 5k 分组数据，不触发大数据模式；大于5k分组数据触发大数据模式，限定展示分组数据5k；特殊说明：多层饼图大数据模式下，分组数据在 5k+ ；
热力地图：限定展示分组数据 2w ；
标准适应条件下：小于等于 5k 分组数据，不触发大数据模式；大于 5k 分组数据触发大数据模式,不同环境展示数据量不同；系统GCC 不满足要求，限定分组数据 10w；系统gcc满足要求，限定分组数据 30w ；
若需要升级系统 GCC，参考 图表大数据GCC升级 。
宽度适应、高度适应、整体适应条件下：小于等于5k分组数据，不触发大数据模式；大于 5k 分组数据，触发大数据模式，不同图形，限定展示的分组数据不同；
（1）热力点，限定分组数据 5w ；
（2）漏斗图、仪表盘、填充地图(非地理坐标系)、文本、饼图、矩形块，限定分组数据 1w；
（3）点、柱形图、线、面积，限定分组数据 10w；
5）在升级前，若灰化的自助数据集出现以下三种情况，在升级后均不标红：
基础表开启实时数据并创建自助数据集 1 ，再关闭实时数据且不更新数据；
本地模式的基础表更新后创建自助数据集 2 ，再删除该基础表；
开启实时数据的基础表创建自助数据集 3 ，再删除该基础表。
6）在 5.1 以及 2019.7 月版本中，若删除了原表后，使用此表在业务包中设置的行权限的表名会丢失，升级到 2020.1 版本后，之前设置的权限依旧是丢失表名的状态，但升级后的版本若删除原表后，会标红并提示表已删除。此现象不影响后续添加条件和用户使用，因此用户删掉有问题的条件即可。
7）7.15 之前的 BI 版本如果有在目录管理<添加链接时无法添加公共链接的问题，且升级之后还需使用旧的内置 FineDB 数据库，升级之后需要手动修改 demo 数据库的字段长度，或者迁移数据库并使用 外接数据库 。
8）若在升级之前使用过 驱动隔离插件 ，需要删除原插件，在升级后需要重新根据 2020-01-15 版本驱动隔离插件 修改。
2019.7 版本升级至 2020.1 版本
1）若用户在升级前的 BI 中使用过数据挖掘功能，那么在升级之前需要把 BI 里面数据挖掘相关的表删掉，再替换 JAR 包，并删掉原来%FineBI%/webapps/webroot/WEB-INF/lib下的fine-bi-datamine-5.1.jar、fine-bi-datamine-third-5.1.jar 的两个包。
2）需要确保升级前后的环境工程 JVM 参数中 国际化 设置一致。如果升级前后的 JVM 参数变化导致升级前后的国际化环境不同，可能会导致 Excel 数据集中空白字段读取错误。
3）在升级后，所有用户都默认关闭公共链接的权限，如果需要用再由管理员开启。（超管账号不做权限限制，升级后正常使用）
4）升级后分类轴在纵向时，默认设置为右对齐。
5）升级后原仪表板的配色方案如果是非自动（例如：彩虹），那么升级后维度与颜色匹配关系仍然保留，只是顺序改变。
6）自助数据集中若有两个新增列且名称一致，在升级后，会提示后添加的新增列字段丢失。因此需要删除后，重新添加对应的新增列。
7）7.15 之前的 BI 版本如果有在目录管理<添加链接时无法添加公共链接的问题，且升级之后还需使用旧的内置 FineDB 数据库，升级之后需要手动修改 demo 数据库的字段长度，或者迁移数据库并使用 外接数据库 。
8）在 5.1 以及 2019.7 月版本中，若删除了原表后，使用此表在业务包中设置的行权限的表名会丢失，升级到 2020.1 版本后，之前设置的权限依旧是丢失表名的状态，但升级后的版本若删除原表后，会标红并提示表已删除。此现象不影响后续添加条件和用户使用，因此用户删掉有问题的条件即可。
9）若在升级之前使用过 驱动隔离插件 ，在升级后需要删除原插件，重新根据 2020-01-15 版本驱动隔离插件 修改。