1. 概述编辑
2. 升级前准备工作编辑
升级前需进行一些升级的准备工作,请参考文档:升级前准备工作
3. 单节点升级编辑
非 web 集群升级 BI 工程步骤如下:
3.1 安装插件「BI升级工具」
1)下载插件。插件获取请联系技术支持(800049425)。
2)安装插件方法请参见:插件管理
安装完插件后,进行单节点升级,视频操作步骤如下:
详细步骤截图,文档说明如下文所示:
3.2 阅读升级注意事项
勾选阅读完上述注意事项之后,可以点击「下一步」进行,如下图所示:
系统会跳出备份提示界面,点击「确定」如下图所示:
如果未进行备份,请参考本文第 2 节。
3.3 选择升级类型
工具会检测当前系统版本以及 jar 时间,并推荐可用的升级类型。
升级至最新版本路线图为:5.1历史版本 → 5.1.1版本 → 5.1.2_历史版本 → 5.1.2_jar2020-07-17版本 → 5.1.5及后续版本
阅读「升级类型介绍」后,根据需要选择合适的升级类型后,继续点击「下一步」,如下图所示:
注:升级 5.1.5-纯直连版本需联系技术支持 QQ(800049425)。
若选择升级类型后,升级的目标版本界面没有「下一步」,则直接点击「执行」,进行下一步操作,可直接跳转至本文 3.4 节进行操作。界面如下图所示:
3.3.1 表模式兼容调整说明
注:仅5.1.2升级到5.1.5模式有此步骤
了解兼容说明后,导出表后,继续点击「下一步」,如下图所示:
兼容说明:
①FIneBI5.1.5版本,将对直连模式和spider模式进行拆分,将不再支持直连模式表和抽取模式表建立关联关系,不再支持抽取和直连混用的自助数据集。对于现有的关联与混用数据表,升级过程中将自动检索现存的所有「混用模式数据表」;并找到这些数据表的「直连模式的父表」,通过复制SQL数据集的方式,对这些父表进行拷贝,复制其数据结果;来实现「抽取」与「直连」模式的分离调整。
②与此同时,直连模式的数据表将不再支持【自循环列】、【行列转换】、【更改字段类型】、【排序】、【自定义分组】、【跨数据源关联】等操作,以下使用了这些功能的数据表将被转至为spider模式。
3.3.2 关联与权限兼容说明
注:仅5.1.2升级到5.1.5模式有此步骤
了解兼容说明后,导出相关数据,点击「执行」进行配置升级,如下图所示:
兼容说明:
①FIneBI5.1.5版本,将对直连模式和spider模式进行拆分,将不再支持直连和spider表、直连自助数据集之间建立关联关系,升级后以下数据表之间的关联关系将丢失。如果这些该关联路径上,存在跨越直连和抽取两种模式的权限配置;那么这些权限也将随之失效。需要升级完成后重新进行权限配置操作。
②权限失效情况如下:1、直连模式的数据表,权限设置时使用了抽取模式的表,进行权限配置。2、抽取模式的数据表,权限设置时使用了直连模式的表,进行权限配置。
3.4 执行配置升级
点击「执行」会进入配置自动升级的界面,如下图所示:
配置升级完成后,会自动跳转下一步操作;并且会自动生成Excel格式升级报告说明,如下图所示:
3.5 上传jar文件
1)输入完信息后,点击「执行」进行jar文件替换,如下图所示:
当前工程 JAR 路径:%FineBI%/webapps/webroot/WEB-INF/lib
上传 zip 文件包:示例为%FineBI%/webapps/webroot/WEB-INF/exchangeJars(zip 包可联系技术支持获取: QQ:800049425)
当前工程的启动路径:%FineBI%/bin/
注:5.1.1-5.1.2 可能会出现下面的内容:
当前工程的启动 JAR路径:%FineBI%/lib(只有exe安装的才有,若是 BI 部署到了其他容器中,则不需要做这个步骤。)
新 JAR 路径:%FineBI%/exchangeJars(只有exe安装的才有,若是 BI 部署到了其他容器中,则不需要做这个步骤。 Jar 包获取请点击:lib)
注意事项:
①上传zip文件包时,直接将「.zip文件」从本地 pc 上传即可,无需解压放置到服务器上。上传成功后路径中将显示/……/WEB-INF/exchangeJars字样。
②Jar包上传受网络传输影响,可能需要稍等几分钟才能完成上传;平均上传时间会在10min以内完成。
③如果多次上传Jar包失败或等待超时,请手动将解压后的新jar文件放置在工程部署服务器WEB-INF\lib路径下,并立即重启。
④如果当前工程jar路径中存在空格或「%」,将会影响 Jar 包的上传与替换;如遇该情况,请手动将解压后的新jar文件放置在工程部署服务器WEB-INF\lib路径下,并立即重启。
⑤当前工程启动路径会获取部署路径下的/……/bin/路径,目前仅支持Tomcat和exe部署的自动获取;如果获取路径空白,不会影响下一步「执行系统升级」,在「完成」后自行重启即可。
2)点击「执行」后,会出现提示界面。点击「确定」执行操作,提示界面如下图所示:
若未进行备份,可参考本文第 2 节。
3.6 完成
如果升级成功则会提示界面如下图所示:
完成界面详情:
系统升级成功,系统将在10s之后立即重启;第一次重启时间较长,请耐心等待。--------//(10s之后执行重启脚本)
注 1 :自动重启功能仅支持 Tomcat 和 exe 部署方式。如果是 Weblogic、Wildfly(JBoss)、Websphere、Docker 服务器部署,请自行立即重启
注 2 :如果重启功能未执行,请自行立即重启。
如果升级失败则会提示:
系统升级失败,请联系BI技术支持;QQ公众号:800049425 定位解决问题。
4. web 集群升级编辑
集群环境有多个节点,处理不同的请求,在开启多个节点的情况下,上述三个功能的请求会被转发到不同的节点处理,会导致升级有误;因此对于集群,我们提供以下两个方案:
4.1 方案一:在开启多个节点升级
1)集群仅使用升级工具的「执行配置升级」功能,不要使用「上传jar文件」功能。步骤详情可参考本文 3.1 -3.4 节。
2)升级操作过程正常流转至该页面时,不要做任何操作。如下图所示:
3)关闭正在运行的 FineBI 工程。
4)拷贝并替换 jar 文件。
将升级的 jar 包,拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中,替换原先的 JAR 包。
5)手动重启 BI 工程。
4.2 方案二:只开一个节点升级
要求:需要操作人员对环境配置比较熟悉。
1)使用升级工具的所有功能,正常升级完成一个节点。步骤详情请参考本文第 3 节。
2)其他节点手动替换跟升级节点相同的 jar 包。
将升级的 jar 包,拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中,替换原先的 JAR 包。
3)重启 BI 工程。
注 1:开哪个节点升级取决于用户的环境配置,有些用户的配置复杂,对节点启动顺序有要求,或者设置了不同节点处理不同的请求,节点不是可以轻易关闭的等等。
注 2:nginx 有文件传输大小和时间的限制,「上传JAR文件」页面的自动换jar功能,上传的 jar 包比较大时,可能会超出 ngnix 的限制,导致上传 jar 失败,此时也手动换 jar 。
5. 验证升级效果编辑
系统重启完成后,查看「管理系统>注册管理」中的版本号和 jar 日期。如果已经变更为新版本,则说明升级成功,如下图所示:
继续检测模板是否都可以正常预览,如果升级过程中遇到其他问题,请联系 BI 技术支持,QQ公众号:800049425 定位解决问题。
6. 升级回退编辑
7. 升级后功能变化编辑
升级后的功能变化:2020-08-04 更新日志