5.1.1-5.1.5升级前准备工作

1.1 版本

1.2 适用版本

适用于 5.1.1 升级到 5.1.2、5.1.3、5.1.5 版本在升级前进行准备工作。

对应的升级文档参见：5.1.1-5.1.5升级指南

升级版本确认及每个版本对应的文档索引参见：升级指南索引

1.3 升级前准备工作流程

5.1.5 之前的版本升级则按照流程进行操作。

历史版本升级会有一些不兼容的问题。因此，升级前建议调整风险场景，降低升级风险。

首先，用户需要对自己的 FineBI 工程进行评估。步骤如下：

1）使用「清理工具」获取系统风险分析结果 Excel，详细请参见：BI 系统清理工具

2）填写 申请升级问卷 ，并上传系统风险分析结果 Excel。

填写完升级问卷后，帆软技术支持将会为您评估升级风险，三个工作日内给您回复；或者直接联系技术支持 QQ（800049425）。

4.1 直连与抽取双引擎独立说明

关于 FineBI 5.1.5 版本直连与抽取双引擎独立说明请参见文档：直连与抽数独立说明

4.2 修改风险项

风险项及修改方式如下表所示：

自 FIneBI 5.1.5 版本开始，将对直连模式和 spider 模式进行拆分，将不再支持直连模式表和抽取模式表建立关联关系，不再支持抽取和直连混用的自助数据集。对于现有的关联与混用数据表，升级过程中将自动检索现存的所有「混用模式数据表」；并找到这些数据表的「直连模式的父表」，通过复制SQL数据集的方式，对这些父表进行拷贝，复制其数据结果；来实现「抽取」与「直连」模式的分离调整。具体方式如图所示：

随着「抽取」与「直连」模式的分离，升级后「抽取」与「直连」模式数据表之间的关联关系也将随之丢失。如果这些该关联路径上，存在跨越直连和抽取两种模式的权限配置；那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作。

权限失效情况如下：1、直连模式的数据表，权限设置时使用了抽取模式的表，进行权限配置。2、抽取模式的数据表，权限设置时使用了直连模式的表，进行权限配置。

与此同时，直连模式的数据表将不再支持【自循环列】、【行列转换】、【更改字段类型】、【排序】、【自定义分组】、【跨数据源关联】等造成严重内存化问题的功能，使用了这些功能的数据表将被转至为抽取模式。

如果使用了「抽取」与「直连」两种模式，升级完后系统将实现两种模式的数据准备模块完全独立。用户依旧可以使用统一的仪表板来添加不同模式的数据，并通过仪表板进行关联分析。

升级前请确认备份好 webroot 文件夹，如果配置了 外接数据库 请同时备份平台配置。系统升级过程都会顺利进行，为确保万无一失，做好系统备份可以在突发情况发生时，快速切换。

用户需要参照 跨版本升级后回退至原版本 判断自己配置的是内置数据库还是外接数据库，并对照文档备份需要的内容。

注：版本升级不支持直接回退，请务必进行备份完成后再执行升级。

6.1 内置数据库

1）关闭 FineBI 。

2）内置数据库的工程备份：若升级前工程没有配置过外接数据库，则需要备份好「webroot」文件夹，在 webroot 路径：%FineBI%\webapps\webroot下拷贝工程。如下图所示：

注：备份会以压缩文件夹形式存放，或者把备份文件拷贝到非工程所在目录，确保 Web 容器里只有一个名为 webroot 的工程。

6.2 外接数据库

外接数据库的工程备份：若升级前配置了外接数据库，需要进入「管理系统>智能运维>备份还原」，在「平台配置」、「报表模板」、「BI模板」、「jar 包」、「插件」 Tab 栏下分别点击「手动备份」，更多详情信息见：备份还原

注：备份会以压缩文件夹形式存放，或者把备份文件拷贝到非工程所在目录，确保 Web 容器里只有一个名为 webroot 的工程。

7.1 必做

详情参见：升级前必须检查内容

7.2 记录权限配置

注：适用于 5.1.3 升级到 5.1.5。

记录权限配置>业务包权限处「登录用户所在字段」的配置，升级后需要手动重新配置。

7.3 修改国际化参数修改

需要修改-Duser.language和-Duser.country为 zh 和 CN

注：服务器系统语言和地区必须是 zh 和 CN。

7.3.1 EXE 版本工程

修改%FineBI_HOME%\bin目录下的文件 finebi.vmoptions 文件，修改内容如下：

-Duser.language=zh
-Duser.country=CN

7.3.2 Tomcat 部署工程

在%Tomcat_HOME%\bin\catalina.sh 第一行添加：

JAVA_OPTS = "$JAVA_OPTS -Duser.language=zh -Duser.country=CN"

7.3.3 Weblogic 部署工程

进入控制台，加上参数 -Duser.language=zh -Duser.country=CN

7.4 基础表修改

5.1.2 版本：基础表A做了编辑（修改了字段类型，取消勾选字段），数据库中修改基础表A的某个字段类型，更新基础表A，可以更新成功。
升级到 5.1.5 版本：更新基础表 A，更新失败，需要重新编辑保存基础表 A 。

7.5 其他问题

1）5.1.3 升级到 5.1.5，如果原来在版本做过删除业务包的操作，可能会有无效行权限的脏数据，需要对该表中 tableID 为 null 的脏数据删除，否则可能导致迁移外置数据库到 oracle 失败。

注：该问题已在5.1.2升级5.1.5工具进行处理。

2）2020-09-01 的 5.1.5 版本新增功能 组件切换数据表；升级到 2020-09-01 及之后的版本，需要删除 BI切换表插件，才可以正常使用仪表板详细设置界面的切换表功能。

3）2020-05-15 版本的 5.1.3 升级到 5.1.5，新建仪表板会出现报错 500 的现象，原因是模板访问 socket 插件无法使用备用方案，需要升级，此插件现在无法在线升级，需要删除后商城重新安装。

关于升级前的其他检查，可参见文档：5.1.x升级FAQ

准备工作结束后前往升级，参考文档：5.1.1-5.1.5升级指南

集群升级，请参考文档：「集群」5.1.1-5.1.5升级指南