1. 概述编辑
1.1 版本
| FineBI 版本 | 功能变动 |
|---|---|
| 5.1 | - |
| 5.1.13 | 升级时支持自动备份外接数据库 |
1.2 适用版本
适用于 5.1.1 升级到 5.1.2 及之后版本，和 5.1.1 之后的版本升级。在升级前进行准备工作。
对应的升级文档参见：5.1.x 升级指南
升级版本确认及每个版本对应的文档索引参见：升级指南索引
1.3 升级前准备工作流程
2. 确定系统当前版本编辑
5.1.5 之前的版本则按照流程进行操作；5.1.5 及后续的 5.1.x 版本升级请直接跳转至本文第 6 节。
3. 系统风险检测编辑
历史版本升级会有一些不兼容的问题。因此，升级前建议调整风险场景，降低升级风险。
首先，用户需要对自己的 FineBI 工程进行评估。步骤如下：
1）使用「清理工具」获取系统风险分析结果 Excel，详细请参见：BI 系统清理工具
2）填写 申请升级问卷 ，并上传系统风险分析结果 Excel。
填写完升级问卷后，帆软技术支持将会为您评估升级风险，三个工作日内给您回复；或者直接联系技术支持 QQ（800049425）。
4. 修改系统风险项编辑
4.1 直连与抽取双引擎独立说明
关于 FineBI 5.1.5 版本直连与抽取双引擎独立说明请参见文档：直连与抽数独立说明
4.2 修改风险项
风险项及修改方式如下表所示：
| 风险类别 | 风险点 | 导致结果 | 修改方式 |
|---|---|---|---|
| 跨数据源使用 | 直连 spider 表混用 | 当前的使用方式会导致进行大量内存计算，严重拖累系统性能，还会增加内存溢出导致宕机的风险 自 BI 5.1.5 版本(jar:2020-08-04)开始，将对直连模式和抽取模式进行拆分，不再支持抽取与直连模式的表配置关联关系，并且直连模式将不再支持跨库关联 如果这些数据表来自不同的数据源(数据库)，直连模式下将无法再关联使用 | 「转为抽取」方式 1 ：升级前将这些数据表转为抽取模式 「需要保留实时性」方式 2 ：升级过程中将会自动断开之间的关联关系，保持数据表可单独使用 |
| 存在异构数据源关联 | |||
| 直连自助数据集-来源表来自不同数据源 | |||
| 基础表 | 直连使用了自循环列 | 当前的使用方式会导致进行大量内存计算，严重拖累系统性能，还会增加内存溢出导致宕机的风险 自 BI 5.1.5 版本(jar:2020-08-04)开始，直连模式(实时化)的数据表，将不再支持该功能 | 升级过程中将自动调整为抽取模式；或者升级前将该数据表转为抽取。 |
| 直连使用了行列转化 | 「转为抽取」方式 1 ：升级前将这些数据表转为抽取模式 「需要保留实时性」方式 2 ： 如果该表为 Excel 数据集，将无法保留实时性效果，升级会自动转为抽取模式。 如果该表为 SQL 数据集，升级前将需改变的字段类型的通过修改 SQL 的方式调整 SQL 数据集 如果该表为 DB 数据集。先使用「BI清理工具」将 DB 数据集转制为 SQL 数据集，再参考上述操作进行修改 | ||
| 直连使用了字段类型改变 | |||
| 自助数据集 | 直连自助数据集排序 | 当前的使用方式会导致进行大量内存计算，严重拖累系统性能，还会增加内存溢出导致宕机的风险 自BI5.1.5版本(jar:2020-08-04)开始，直连模式(实时化)的数据表，将不再支持该功能 | 升级过程中将自动调整为抽取模式；或者升级前将该数据表转为抽取 |
| 直连自助数据集日期过滤前 N 个/后 N 个 | |||
| 直连自助数据集数值过滤前 N 个/后 N 个 | |||
| 直连自助数据集-数值过滤-大/小于等于平均值 | |||
| 直连自助数据集-数值汇总-同期环期/同比环比 | |||
| 直连自助数据集-文本汇总-字符串拼接 | |||
| 自助数据集自定义分组使用了复制到分组 | 该功能导致底层结构会导致严重性能问题，BI 5.1.5 版本(jar:2020-08-04)，暂时不再支持该功能 BI 5.1.6 版本(jar:2020-09-30)，该功能从「分组汇总步骤」调整至「新增列步骤」，并优化了之前的性能问题 | 升级完成后，需要重新操作在「自助数据集-新增列」中添加需要复制的分组；并调整相应的仪表板 | |
| 仪表板功能 | 模版使用了直连不支持的日期过滤 | 当前的使用方式会导致进行大量内存计算，严重拖累系统性能，还会增加内存溢出导致宕机的风险 自BI5.1.5版本(jar:2020-08-04)开始，基于直连模式(实时化)数据表制作的组件或仪表板，将不再支持某些特定的日期过滤方式 不再支持的特定的过滤方式如下：「日期字段」设置「包含/不包含、开头是/结尾是、开头不是/结尾不是」 | 「转为抽取」方式1：升级前将对应的数据表转为抽取模式 「需要保留实时性」方式2：升级前将所使用的过滤条件删除，并通过其他条件进行替代，实现之前过滤要求 |
| 权限 | 自循环列表当登陆者信息表 | 自 BI 5.1.5 版本(jar:2020-08-04)开始，将对直连模式和抽取模式进行拆分，不再支持抽取与直连模式的表配置关联关系，并且直连模式将不再支持跨库关联 如果这些该关联路径上，存在跨越直连和抽取两种模式的权限配置；那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作 权限失效情况如下：1、直连模式的数据表，权限设置时使用了抽取模式的表，进行权限配置。2、抽取模式的数据表，权限设置时使用了直连模式的表，进行权限配置 | 「转为抽取」方式1：升级前将这些数据表转为抽取模式 「需要保留实时性」方式2：升级过程中会断开这类关联关系，权限也会随之失效；升级完成后根据需要重新配置 |
| 配置权限的表的关联存在异数据源关联 | |||
| 配置权限的表的关联存在混用数据集 |
5. 阅读升级工作方式编辑
自 FIneBI 5.1.5 版本开始，将对直连模式和 spider 模式进行拆分，将不再支持直连模式表和抽取模式表建立关联关系，不再支持抽取和直连混用的自助数据集。对于现有的关联与混用数据表，升级过程中将自动检索现存的所有「混用模式数据表」；并找到这些数据表的「直连模式的父表」，通过复制SQL数据集的方式，对这些父表进行拷贝，复制其数据结果；来实现「抽取」与「直连」模式的分离调整。具体方式如图所示：
随着「抽取」与「直连」模式的分离，升级后「抽取」与「直连」模式数据表之间的关联关系也将随之丢失。如果这些该关联路径上，存在跨越直连和抽取两种模式的权限配置；那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作。
权限失效情况如下：1、直连模式的数据表，权限设置时使用了抽取模式的表，进行权限配置。2、抽取模式的数据表，权限设置时使用了直连模式的表，进行权限配置。
与此同时，直连模式的数据表将不再支持【自循环列】、【行列转换】、【更改字段类型】、【排序】、【自定义分组】、【跨数据源关联】等造成严重内存化问题的功能，使用了这些功能的数据表将被转至为抽取模式。
如果使用了「抽取」与「直连」两种模式，升级完后系统将实现两种模式的数据准备模块完全独立。用户依旧可以使用统一的仪表板来添加不同模式的数据，并通过仪表板进行关联分析。
6. 进行系统备份编辑
升级前请确认备份好 webroot 文件夹，如果配置了 外接数据库 请同时备份平台配置。系统升级过程都会顺利进行，为确保万无一失，做好系统备份可以在突发情况发生时，快速切换。
用户需要参照 跨版本升级后回退至原版本 判断自己配置的是内置数据库还是外接数据库，并对照文档备份需要的内容。
注：版本升级不支持直接回退，请务必进行备份完成后再执行升级。
6.1 内置数据库
1）关闭 FineBI 。
2）内置数据库的工程备份：若升级前工程没有配置过外接数据库，则需要备份好「webroot」文件夹，在 webroot 路径：%FineBI%\webapps\webroot下拷贝工程。如下图所示：
注：备份会以压缩文件夹形式存放，或者把备份文件拷贝到非工程所在目录，确保 Web 容器里只有一个名为 webroot 的工程。
6.2 外接数据库
外接数据库的工程备份：若升级前配置了外接数据库，需要进入「管理系统>智能运维>备份还原」，在「平台配置」、「报表模板」、「BI模板」、「jar 包」、「插件」 Tab 栏下分别点击「手动备份」，更多详情信息见：备份还原
注：备份会以压缩文件夹形式存放，或者把备份文件拷贝到非工程所在目录，确保 Web 容器里只有一个名为 webroot 的工程。
若不想手动进行备份，5.1.13 之后的版本支持在升级过程中自动进行备份。
使用 FINE_CONF_ENTITY可视化配置 插件，点击「管理系统>系统工具」，选择「自定义参数配置」，输入系统参数名「BIUpdateConfig.autoBackup」和系统参数值「true」，点击保存，如下图所示：
则会在升级时自动判断是否有升级当天的外接数据库备份，若没有则会在升级前自动进行备份。
7. 升级前检查编辑
7.1 记录权限配置
记录权限配置>业务包权限处「登录用户所在字段」的配置，升级后需要手动重新配置。
7.2 修改国际化参数修改
需要修改-Duser.language和-Duser.country为zh和CN
注：服务器系统语言和地区必须是 zh 和 CN。
7.2.1 EXE 版本工程
修改%FineBI_HOME%\bin目录下的文件 finebi.vmoptions 文件，修改内容如下：
-Duser.language=zh
-Duser.country=CN
7.2.2 Tomcat 部署工程
在%Tomcat_HOME%\bin\catalina.sh 第一行添加：
JAVA_OPTS = "$JAVA_OPTS -Duser.language=zh -Duser.country=CN"
7.2.3 Weblogic 部署工程
进入控制台，加上参数 -Duser.language=zh -Duser.country=CN
7.3 检查外接数据库
如果迁移了外接数据库，检查%FineBI_HOME%\webroot\WEB-INF\config\db.properties中 hibernate.hbm2ddl.auto 值是否设置为 update，如果不是，则在升级时不会自动检查更新表结构，可能导致行权限等配置丢失。
如果升级到 5.1.11 和之后的版本，且外接数据库是 mysql 数据库，且表数据量很多，需要将数据库 max_allowed_packet 参数项调整为 1073741824，即 1G，升级完成后建议再改回原来的数值。
参数检查：
show VARIABLESlike'%max_allowed_packet%'参数过小，升级日志中的关键报错：jdbc.PacketTooBigException: Packet for query is too large (1036056 > 999424). You can change this value on the server by setting the max_allowed_packet' variable
7.4 函数兼容问题
升级 5.1.12 版本，为了升级兼容函数问题，启动会比较慢，请耐心等待。
7.5 websphere部署注意事项
由于 BI 使用了 servlet 3.0 的 api，如果 websphere（websphere 9.0 默认提供了 servlet 3.0 的 jar） 没有提供 servlet 3.0 的 jar，启动就会报错。
目前有两种方式规避掉报错：
需要 websphere 提供 servlet 3.0 的运行环境（最好 websphere 能提供）
将 servlet 3.0 的 jar 包放入到 BI 的 %FineBI_HOME%\webroot\web-inf\lib 目录下。
8. 注意事项编辑
关于升级前的其他检查，可参见文档：5.1.x升级FAQ
9. 升级编辑
准备工作结束后前往升级，参考文档：5.1.x 升级指南
集群升级，请参考文档：「集群」5.1.x升级指南