5.1.x升级指南

  • 文档创建者:April陶
  • 编辑次数:21次
  • 最近更新:Roxy 于 2021-01-26
  • 1. 概述

    1.1 确认版本

    请参见升级索引查看升级所对应的版本:升级指南索引

    本文介绍 5.1.x 单节点升级指南,集群 5.1.x 升级指南参见文档:「集群」5.1.x升级指南

    1.2 升级流程

    1605517326974934.png

    2. 升级前准备工作

    升级前需进行一些升级的准备工作,请参考文档:5.1.x升级前准备工作

    3. 单节点升级

    非 web 集群升级 BI 工程步骤如下:

    注:若用户从 5.1.2-5.1.5 升级,且使用了nginx转发,nginx有文件传输大小和时间的限制,可能会出现插件安装失败,jar包上传失败的问题,IP+端口访问可以避免。

    3.1 安装插件「BI升级工具」

    1)下载插件。插件获取请联系技术支持(800049425)。

    2)安装插件方法请参见:插件管理 ,

    • 安装完插件后,进行单节点升级,视频操作步骤如下:

    2020-11-17_13-56-24.gif

    • 详细步骤截图,文档说明如下文所示:

    3.2 阅读升级注意事项

    勾选阅读完上述注意事项之后,可以点击「下一步」进行,如下图所示:

    2020-11-16_19-06-46.png

    系统会跳出备份提示界面,点击「确定」如下图所示:

    如果未进行备份,请参考本文第 2 节。

    2020-11-16_19-10-10.png

    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)。

    2020-11-17_9-29-28.png

    • 若选择升级类型后,升级的目标版本界面没有「下一步」,则直接点击「执行」,进行下一步操作,可直接跳转至本文 3.4 节进行操作。界面如下图所示:

    image2020-11-12_15-43-22.png

    3.3.1 表模式兼容调整说明

    注:仅5.1.2升级到5.1.5模式有此步骤

    了解「表模式兼容调整说明」后,导出表后,继续点击「下一步」,如下图所示:

    1605579501983752.png

    3.3.2 关联与权限兼容说明

    注:仅 5.1.2 升级 5.1.5 有此步骤,且配置升级只能执行一次,不能多次执行。

    了解「关联与权限兼容说明」后,导出相关数据,点击「执行」进行配置升级,如下图所示:

    3.4 执行配置升级

    3.4.1 操作步骤 

    点击「执行」会进入配置自动升级的界面,如下图所示:

    2020-11-17_10-23-04.png

    配置升级完成后,会自动跳转下一步操作;并且会自动生成 Excel 格式「升级报告说明」,如下图所示:

    2020-11-17_10-23-18.png

    3.4.2 注意事项

    1)执行配置升级的步骤会自动检测,外置数据库权限。

    自动检查%FineBI%/webapps/webroot/WEB-INF/config下的db.properties的配置是否正确, db.properties 中下图位置配置必须为 update:

    image2020-12-15_15-39-57.png

    插件自动检测外接数据库用户数据库 DDL 权限,用户必须要有 DDL 权限。外接数据库用户如下图所示:

    2020-12-17_15-07-34.png

    如果上述两项任意一项检测不过,报错均如下图所示:

    image2020-12-14_18-52-49.png

    解决方法:运维人员去检查对应的权限。

    如果确认是第(2)项检测不过,可以查看 fanruan.log,搜索关键字 create db table or insert data failed ,查看数据库详细报错信息。

    2)若自助数据集数据处理表依赖了数据分析表,报错提示如下图所示:

    企业微信截图_16079380044671.png

    解决方法:联系技术支持解决问题 QQ(800049425)。

    3.5 上传jar文件

    3.5.1 自动换 JAR

    1)先相信阅读「上传Jar文件」的注意事项,再输入完信息后,点击「执行」进行 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

    1605580123517731.png

    2)点击「执行」后,会出现提示界面。点击「确定」执行操作,提示界面如下图所示:

    若未进行备份,可参考本文第 2 节。

    2020-11-16_19-43-31.png

    2020-11-16_19-43-44.png

    3.5.2 手动换 JAR

    注 1:通常情况下,按照升级工具指引步骤操作即可。如果上传 Jar 文件失败,可选择手动换 Jar 。

    注 2:5.1.2 升级 5.1.5,配置升级只能执行一次,不能多次执行。如果换jar失败,不用再执行前面的步骤,直接手动换 jar 即可。

    操作失败后,手动换 Jar 步骤如下:

    1)关闭正在运行的 FineBI 工程。

    2)拷贝并替换 jar 文件。

    将升级的 jar 包,拷贝至 FineBI 目录%FineBI%/webapps/webroot/WEB-INF/lib中,替换原先的 JAR 包。

    3)手动重启 BI 工程。

    结束可跳转第 4 节,验证升级效果。

    3.6 完成

    如果升级成功则会提示界面如下图所示:

    2020-11-16_19-44-09.png

    完成界面详情:

    系统升级成功,系统将在10s之后立即重启;第一次重启时间较长,请耐心等待。--------//(10s之后执行重启脚本)

    注 1 :自动重启功能仅支持 Tomcat 和 exe 部署方式。如果是 Weblogic、Wildfly(JBoss)、Websphere、Docker 服务器部署,请自行立即重启

    注 2 :如果重启功能未执行,请自行立即重启。

    如果升级失败则会提示:

    系统升级失败,请联系 BI 技术支持(QQ:800049425 )定位解决问题。

    4. 验证升级效果

    系统重启完成后,查看「管理系统>注册管理」中的版本号和 jar 日期。如果已经变更为新版本,则说明升级成功,如下图所示:

    2020-11-17_13-32-09.png

    继续检测模板是否都可以正常预览,如果升级过程中遇到其他问题,请联系 BI 技术支持(QQ:800049425 )定位解决问题。

    注意事项:

    只有5.1.5之后的版本才会显示小版本号。之前的版本显示为 5.1.0 ,可以根据 JAR 的日期来确定版本。

    下表为每个小版本第一次发布的 JAR 包日期。若在 JAR 包日期在两个版本中间,则为较早的版本。

    FineBI 版本号
    JAR 包日期
    5.02018-09-01
    5.12019-01-15
    5.1.12019-05-15
    5.1.22019-11-08
    5.1.5
    2020-08-04

    例如,下图是 2020.08.04 的 JAR ,因此是5.1.5的版本。

    下载.png

    5. 升级回退

    若出现升级失败等原因,需要回退原来的旧版本。

    升级回退请参见:跨版本升级回退至原版本

    6. 升级后功能变化

    升级后的功能变化:更新日志

    注:根据自己对应的 JAR 包和版本查看该日期及之前的功能变化。

    附件列表


    主题: 产品简介
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526