最新历史版本 :5.1.1-5.1.5版本升级指南(单机) 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 确认版本

升级版本确认及每个版本对应的文档索引参见:FineBI 版本说明

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

1.2 升级流程

2020-11-16_14-56-08.png

2. 升级前准备工作编辑

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

3. 单节点升级编辑

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

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

1)下载插件。插件获取请前往 【服务平台>在线支持】

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-纯直连版本建议前往 【服务平台>在线支持】

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 执行配置升级

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

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

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

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

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 包可联系技术支持获取, 【服务平台>在线支持】

  • 当前工程的启动路径:%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 :如果重启功能未执行,请自行立即重启。

如果升级失败则会提示:

系统升级失败,建议前往 【服务平台>在线支持】定位解决问题。

4. 验证升级效果编辑

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

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

继续检测模板是否都可以正常预览,如果升级过程中遇到其他问题,建议前往 【服务平台>在线支持】定位解决问题。

5. 升级回退编辑

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

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

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

6. 升级后功能变化编辑

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

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