反馈已提交

网络繁忙

您好,只有最新版本的6.X支持在线编辑修改,如果想创建/编辑文档,请移步到 *最新版本*

5.1.18-5.1.19及之后版本升级指南

  • 文档创建者:Roxy
  • 历史版本:15
  • 最近更新:April陶 于 2024-01-29
  • 由于 FineBI 5.1.19 适配的 FineReport 11.0.1属于大版本更新,因此必须更换 Lic ,若有疑问,请请前往 【服务平台>在线支持】联系技术支持获取帮助。

    1. 概述

    1.1 版本

    FineBI 版本内容变动
    5.1.19(适配 FR 11.0.1)

    BI 5.1.15(JAR 日期为:2021.08.05)至 5.1.18 版本才可以使用此工具

    注:如果是5.1.15之前的版本,需要将工程先升级到5.1.15至5.1.18之间的任意版本,再使用本文工具升级。

    5.1.20(适配 FR 11.0.2)

    BI 5.1.5(JAR 日期为:2020.08.07)至 5.1.18 版本均可以使用此工具。

    1.2 应用场景

    FineBI 5.1.19 适配 FineReport 11.0.1,因此提供该升级工具,若你需要将 BI 工程升级至 5.1.19 以及之后的版本,可参考本文进行升级操作。

    1.3 使用范围

    见本文 1.1 节功能变动。

    版本信息可在 注册管理 中查看。

    1.4 注意事项

    1.4.1 升级前必看

    升级前的注意事项详情请参见文档:BI5.x版本适配FR10.0/11.0维护策略公告

    1.4.2 集群升级

    • 集群环境升级请先停止所有节点的进程,在其中任一节点运行升级工具,完成升级后将当前节点的 webroot 文件下的 WEB-INF、scripts、upm 拷贝到其他节点,完成后先启动一个节点,待工程可以访问后,再依次启动其他的节点。

    • 如果配置了外接数据库、状态服务器、文件服务器,升级过程需要保证均可以正常连接,以便更新文件。

    1.4.3 更换 netty JAR包

    5.1.26之前版本升级至5.1.26及之后版本,请手动删除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib下 netty 相关 jar 包。
    5.1.26及之后版本,产品内置了netty-all-4.1.78.Final.jar相关功能,因此需要删除额外的jar,否则可能无法正常启动工程。
    如需从高版本回退至5.1.26之前版本,需要额外在服务器工程 %Tomcat_HOME%/webapps/webroot/WEB-INF/lib 目录下加上netty相关jar包。点击下载JAR包:netty安全驱动

    2. 操作步骤

    2.1 获取升级工具

    若您是未联系帆软销售经理的个人用户,可致电 400-8118890 转1 与帆软商务联系获取相关资讯;

    若您已与帆软销售经理有对接,请前往 【服务平台>在线支持】获取升级工具和 「BI升级」插件包。

    2.2 确认已有的注册功能

    由于升级后必须更换 Lic 文件,因此在升级前可先确定已有的注册功能点,详情参见:注册管理

    2.3 工程备份

    进入「管理系统>系统管理>常规」,确认数据库类型,如下图所示:

    • 如果显示「待配置」:则数据库类型为内置数据库

    • 如果显示「已配置」:则数据库类型为外置数据库

    • 内置数据库备份方式:

    关闭 FineBI 工程,在路径%FineBI%\webapps\webroot下拷贝 webroot 文件夹(备份的 webroot 文件不能放在 FineBI 的安装路径下)

    注:如果 webroot 比较大(超过4G),备份需要的时间太长,可以只备份 webroot 下的 WEB-INF 文件夹;如果 WEB-INF 也非常大(超过2G),备份需要的时间还是特别长,可以只备份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources 文件夹。

    • 外接数据库备份方式:

    方案一:

    1)关闭 FineBI 工程,在路径%FineBI%\webapps\webroot下拷贝 webroot 文件夹(备份的 webroot 文件不能放在 FineBI 的安装路径下)

    注1:如果 webroot 比较大(超过 4G),备份需要的时间太长,可以只备份 webroot 下的 WEB-INF 文件夹;如果 WEB-INF 也非常大(超过 2G ),备份需要的时间还是特别长,可以只备份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources文件夹。

    注2:集群环境有几个节点则备份几个 webroot 工程。

    2)手动备份好外接数据库,备份数据库的密码需要和之前数据库的一致。

    方案二:

    进入「管理系统>智能运维>备份还原」,分别对「平台配置 、报表模板、BI模板、Jar包、插件」进行「手动备份」,如下图所示:

    注:2020.01.15 之前发布的 FineBI 不能成功备份钉钉配置。

    2.4 进行升级检测

    参考 5.1.5-5.1.18版本升级指南 2.2 节内容进行升级前的检测,并根据你的实际情况修改「阻塞项」和「建议项」。

    2.5 关闭工程

    备份完成后关闭 BI 工程。

    常见问题:Windows系统直接关闭工程后,往往防宕机插件进程还在,会导致升级过程替换 jar 失败,从而升级失败。

    处理方法:1)进入cmd;2)输入 jps ,查看是否有名字为 Operation 的进程;3)如果有,输入taskkill /f /pid %pid%,杀掉名字为Operation的进程。如下图所示:

    1662552948737275.png


    验证是否完全关闭的方法:修改%FineBI%\webapps\webroot\WEB-INF下的 lib 文件的文件名称,能修改,则说明工程已经完成关闭。(修改后要记得名字改回来)

    2.6 运行升级工具

    注1:升级过程会占用 20216 和 20217 端口,请确认端口未被其他进程占用。

    注2:升级工具运行时的内存默认为 Xms:4G  -Xmx:物理内存的一半,需要保证服务器至少有8G的可用内存,防止升级过程内存溢出。

    注3:集群环境只能对一个节点进行升级,升级后将升级好的webroot拷贝到其他的节点。

    注4:升级工具日志在工具同级目录下,名字为 upgrade.log。

    2.6.1 Windows 系统升级

    运行升级工具,选择BI 工程 webroot 所在的位置,然后点击开始升级,如下图所示:

    注:升级工具和工程所在路径不要包含较多特殊字符,可包含中文、英文、数字、英文括号、下划线、英文连接符、空格(一般不要将工程放在 C 盘内)。

    等待升级完成,如下图所示:

    注:升级完成后,启动之前检查 %FineBI%/webroot/WEB-INF/lib下的 jar 是否正确,因为 windows 环境特性,文件被系统占用,可能删不掉10.0的 jar。

    2.6.2 Linux 系统升级

    在 Linux 系统中下载升级工具后,使用命令 chmod 777 升级工具 sh 文件名给工具授予权限,如下图所示:

    然后启动升级工具,如下图所示:

    输入工程 webroot 路径,并等待升级,如下图所示:

    升级完成后提示:升级成功,如下图所示:

    2.7 重启工程

    升级结束,工程处于关闭状态,需要手动启动工程。

    2.8 更换 Lic 文件

    升级至 5.1.19 后,需要更换Llic,更换的 Lic 功能与之前的 Lic 功能需要保持一致,详情参见:注册管理

    3. 注意事项

    3.1 插件

    当前 FR11.0 只适配了官方插件,所以第三方插件、定制插件可能会出现升级后无法使用的情况。

    3.2 其他

    如果一个工程已经升级过,不管是否升级成功,都不要再次运行升级工具来升级。需要恢复备份,重新升级。

    如果工程配置了外接数据库,升级工具自带的数据库驱动可能连不上外接数据库,导致升级失败,此时建议切换为内置数据库进行升级后,再迁移出去。

    附件列表


    主题: 安装与升级
    已经是第一篇
    已经是最后一篇
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

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

    在线QQ(将在2023.01.03关停):800049425

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭