反馈已提交

网络繁忙

您正在浏览的是 FineBI6.0 帮助文档,点击跳转至: FineBI5.1帮助文档

5.X-6.0.5备份升级回退方案

  • 文档创建者:April陶
  • 历史版本:9
  • 最近更新:文档组 于 2023-06-07
  • 1. 概述

    有些情况下,用户可能需要恢复到升级前的版本。

    文档提供升级后回退至原版本,再进行升级的操作步骤。

    2. 确认数据库类型

    进入「管理系统>系统管理>常规」可以看到是否使用了外接数据库,如下图所示:

    2022-09-14_11-19-43.png

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

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

    3. 单机(内置数据库)

    如果使用了文件服务器,可以参考第 5 节集群的文件服务器内容进行备份还原。

    3.1 升级前备份

    回退使用内置数据库的工程,需要用户在升级前进行以下备份:

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

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

    3.2 回退步骤

    1)关闭 BI 服务器

    2)替换工程

    若在升级前使用内置数据库,将备份的旧工程 webroot 文件,替换%FineBI%\webapps路径下的 webroot 文件即可,如下图所示:

    2022-09-14_15-14-22.png

    注:如果只备份了WEB-INF,就恢复备份的WEB-INF,启动工程;如果只备份了 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets 文件夹,那么就恢复对应的文件夹。

    3)重启 BI 服务器。

    3.3 升级

    详情参考:6.0升级

    4. 单机(外置数据库)

    4.1 方法一(推荐)

    4.1.1 升级前备份

    方法一要求用户在升级前进行过以下备份:

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

    注:如果 WEB-INF 也非常大(超过 2G ),备份需要的时间还是特别长,可以只备份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets以及assets\temp_attach\holder文件夹。

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

    4.1.2 回退步骤

    1)关闭 BI 服务器。

    2)替换工程

    将备份的旧工程 webroot 文件,替换%FineBI%\webapps路径下的 webroot 文件,如下图所示:

    2022-09-14_15-14-22.png

    注:如果只备份了 WEB-INF,就恢复备份的 WEB-INF;如果只备份了 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets文件夹,那么就恢复对应的文件夹。

    3)恢复外接数据库

    若为新建一个数据库备份外接数据库,即备份恢复的数据库名、用户名、密码等与之前的数据库名不一致,则修改%FineBI%/webapps/webroot/WEB-INF/config路径下的 db.properties ,根据备份的数据库的连接信息对文件进行修改,如下图所示:

    33.png

    若备份恢复的数据库的数据库名、用户名、密码等跟之前的数据库的名字一样,则不需要修改其他的配置。

    4)启动  FineBI 完成回退。

    4.2 方法二

    4.2.1 升级前备份

    使用方法二需要用户在升级前进行过以下备份:

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

    1611646188572529.png

    2)手动备份 WEB-INF 下的 assets\temp_attach\holder 文件夹。

    4.2.2 回退步骤

    1)关闭 FineBI 工程。

    2)恢复报表模板。

    %FineBI%/webapps/webroot/WEB-INF目录下的 reportlets 文件夹删除;在%FineBI%/webapps/webroot/backup/reportlets/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 reportlets 文件夹复制到%FineBI%/webapps/webroot/WEB-INF目录下。

    3)恢复 BI 模板。

    %FineBI%/webapps/webroot/WEB-INF目录下的 dashboards 文件夹删除;在%FineBI%/webapps/webroot/backup/dashboards/manual下,根据文件夹的名字(备份时间),找到备份的内容,将dashboards 文件夹复制到%FineBI%/webapps/webroot/WEB-INF目录下;

    4)恢复 jar包。

    %FineBI%/webapps/webroot/WEB-INF目录下的 lib 文件夹删除;

    %FineBI%/webapps/webroot/backup/jar/manual下,根据文件夹的名字(备份时间),找到备份的内容,将lib文件夹复制到%FineBI%/webapps/webroot/WEB-INF目录下;

    5)恢复插件。

    %FineBI%/webapps/webroot/WEB-INF目录下的 plugins 文件夹删除;

    %FineBI%/webapps/webroot/backup/plugins/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 plugins 文件夹复制到%FineBI%/webapps/webroot/WEB-INF目录下;

    6)恢复外置数据库。

    %FineBI%/webapps/webroot/backup/config/manual下,根据文件夹的名字(备份时间),找到备份的内容,将备份的config.zip 解压得到的 finedb,替换%FineBI%/webapps/webroot/WEB-INF/embed下的 finedb 文件,如下图所示:

    1601027166260835.png

    %FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 文件删除;此文件删除后,工程启动就读内置 finedb 的内容。

    7)启动工程,完成回退,用户可以根据需要,重新配置外接数据库。

    4.3 升级

    详情参考:6.0升级

    5. 集群(使用文件服务器)

    5.1 方法一(推荐使用)

    【备份】

    1)关闭工程所有的节点;

    2)备份各个节点的webroot文件夹;

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

    3)备份文件服务器上的WEB-INF文件夹;

    注:如果WEB-INF比较大(超过2G),备份需要的时间太长,文件服务器上可以只备份WEB-INF下的dashboards、reportlets以及assets\temp_attach\holder文件夹。

    4)数据库端备份外置数据库。备份的数据库的密码要跟之前的外置数据库一样。

    【还原】

    1)各节点恢复之前备份的webroot;

    注:如果只备份了WEB-INF,就恢复备份的WEB-INF;如果只备份了WEB-INF下的lib、plugins文件夹,那么就恢复对应的文件夹;

    2)恢复文件服务器上的WEB-INF文件夹;

    如果只备份了WEB-INF下的dashboards、reportlets文件夹,那么就恢复对应的文件夹;

    3)恢复外置数据库;

    • 备份恢复的数据库的数据库名、用户名等跟之前的不一样,恢复时需要修改以下配置:

    修改集群各节点%FineBI%/webapps/webroot/WEB-INF/config路径下的db.properties,根据备份的数据库的连接信息进行修改

    1601363507979903.png

    • 备份恢复的数据库的数据库名、用户名、密码等跟之前的数据库的名字一样,则不需要修改db.properties的配置;

    4)依次启动集群各节点。

    5.2 方法二

    【备份】

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

    1611646188572529.png

    2)手动备份WEB-INF下的assets\temp_attach\holder文件夹

    【还原】

    备份的内容在文件服务器上,到文件服务器上 WEB-INF 同层级目录下找到 backup 文件夹。

    1)恢复报表模板。

    将文件服务器 WEB-INF 目录下的 reportlets 文件夹删除;

    在文件服务器backup/reportlets/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 reportlets 文件夹复制到文件服务器的 WEB-INF 目录下;

    2)恢复 BI模板。

    将文件服务器 WEB-INF 目录下的 dashboards 文件夹删除;

    在文件服务器backup/dashboards/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 dashboards 文件夹复制到文件服务器的 WEB-INF 目录下;

    3)恢复jar包。

    将集群各节点/webapps/webroot/WEB-INF目录下的 lib 文件夹删除;

    backup/jar/manual下,根据文件夹的名字(备份时间),找到备份的内容,将lib文件夹复制到集群各节点%FineBI%/webapps/webroot/WEB-INF目录下。

    4、恢复插件。

    将集群各节点下的 plugins 文件夹删除;

    在文件服务器backup/plugins/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 plugins 文件夹复制到集群各节点%FineBI%/webapps/webroot/WEB-INF目录下。

    5、恢复外置数据库。

    在文件服务器backup/config/manual下,根据文件夹的名字(备份时间),找到备份的内容,将备份的 config.zip 解压得到的 finedb ,替换集群一个节点%FineBI%/webapps/webroot/WEB-INF/embed下的 finedb 文件;

    2022-09-14_15-29-37.png

    将集群这个节点下的%FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 文件删除。(此文件删除后,工程启动就读内置 finedb 的内容了)

    6、启动集群的这个节点。

    7、启动成功后,配置外接数据库。

    8、将这个节点%FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 文件,拷贝到集群其他节点的FineBI/webapps/webroot/WEB-INF/config下。

    9、 启动其他的节点。

    5.3 升级

    参考文档:6.0集群升级

    6. 集群(使用节点间同步)

    6.1 方法一(推荐使用)

    【备份】

    1)关闭工程所有的节点;

    2)备份各个节点的 webroot 文件夹;

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

    3)数据库端备份外置数据库。备份的数据库的密码要跟之前的外置数据库一样。

    【还原】

    1)集群各节点恢复之前备份的 webroot。

    注:如果只备份了WEB-INF,就恢复备份的WEB-INF;如果只备份了WEB-INF下的dashboards、lib、plugins、reportlets文件夹,那么就恢复对应的文件夹。

    2)恢复外置数据库;

    • 备份恢复的数据库的数据库名、用户名等跟之前的不一样,恢复时需要修改以下配置:

    修改集群各节点%FineBI%/webapps/webroot/WEB-INF/config路径下的 db.properties ,根据备份的数据库的连接信息进行修改

    1601363507979903.png

    •  备份恢复的数据库的数据库名、用户名、密码等跟之前的数据库的名字一样,则不需要修改db.properties的配置;

    3)依次启动集群各节点。

    6.2 方法二

    【备份】

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

    1611646188572529.png

    2)手动备份主节点WEB-INF下的assets\temp_attach\holder文件夹。

    【还原】

    备份的内容在集群主节点的FineBI/webapps/webroot/backup下。

    1)恢复报表模板。

    将集群各节点%FineBI%/webapps/webroot/WEB-INF目录下的 reportlets 文件夹删除;

    %FineBI%/webapps/webroot/backup/reportlets/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 reportlets 文件夹复制到集群各节点%FineBI%/webapps/webroot/WEB-INF目录下。

    2、恢复BI模板。

    将集群各节点%FineBI%/webapps/webroot/WEB-INF目录下的 dashboards 文件夹删除;

    %FineBI%/webapps/webroot/backup/dashboards/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 dashboards 文件夹复制到集群各节点%FineBI%/webapps/webroot/WEB-INF目录下;

    3、恢复 jar 包。

    将集群各节点%FineBI%/webapps/webroot/WEB-INF目录下的 lib 文件夹删除;

    %FineBI%/webapps/webroot/backup/jar/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 lib 文件夹复制到集群各节点%FineBI%/webapps/webroot/WEB-INF目录下;

    4、恢复插件。

    将集群各节点%FineBI%/webapps/webroot/WEB-INF目录下的 plugins 文件夹删除;

    %FineBI%/webapps/webroot/backup/plugins/manual下,根据文件夹的名字(备份时间),找到备份的内容,将 plugins 文件夹复制到集群各节点%FineBI%/webapps/webroot/WEB-INF目录下;

    5)恢复外置数据库。

    %FineBI%/webapps/webroot/backup/config/manual下,根据文件夹的名字(备份时间),找到备份的内容,将备份的 config.zip 解压得到的 finedb,替换%FineBI%/webapps/webroot/WEB-INF/embed下的 finedb 文件,如下图所示:

    %FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 文件删除;此文件删除后,工程启动就读内置 finedb 的内容。

    6)启动集群的这个节点;

    7)启动成功后,配置外接数据库。

    8)将这个节点%FineBI%/webapps/webroot/WEB-INF/config下的db.properties文件,拷贝到集群其他节点的%FineBI%/webapps/webroot/WEB-INF/config下。

    9)启动其他的节点。

    6.3 升级

    参考文档:6.0集群升级

    7. 回退注意事项(单机&集群)

    7.1 更新

    因为升级后会将所有的设置了随父表更新的自助数据集都更新一遍,因此自助数据集更新的 db 文件结构会改变,如果回退到 5.1 版本,一些自助数据集可能因为更新的 db 文件结构变动导致预览失败,需要重新更新一下才能正常展示;

    如果需要更新的表太多,又不方便进行全局更新,可以设置如下参数:

    • 表:fine_conf_entity

    • id:DistributedOptimizationConfig.spiderConfig.spider_ignore_base_update   

    • value:true

    设置参数后,工程需要重启才能生效;

    设置这个参数后,再触发全局更新,遇到基础表会直接跳过更新,只更新自助数据集。

    7.2 插件

    5.1.18及之前版本升级到 6.0 需要注意此项。

    BI 5.1.18 及之前(FR10)和之后(FR11)的版本插件商城资源不一样。

    如果是 FR10 版本升级到 FR11 版本,升级工具会直接将插件商城资源替换为 FR11 的资源;这种情况下如果要回退的话,内网客户需要手动将插件商城资源替换为 FR10 版本的资源;

    5.1.18及之前(FR10)版本插件商城资源路径:%FineBI%/webapps/webroot下资源文件 scripts.zipupm.zip,下载下来后,解压到%FineBI%/webapps/webroot下。

    附件列表


    主题: 部署集成
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

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

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

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持