1. 概述
1.1 版本
运维平台版本 | 功能变更 |
---|---|
V1.5.5 | - |
V1.12.0 | 调整运维项目还原要求,存在24小时内备份即可还原 |
V1.16.0 | 备份还原支持FineDataLink项目 |
V2.3.0 | 1)支持对不可用项目进行还原 2)若存在不可用服务器,支持在还原时重新指定新节点 |
1.2 应用场景
运维平台对项目进行备份后,支持通过备份文件还原项目。
2. 还原运维平台部署的项目
运维平台部署的项目,支持通过前端界面化一键还原。
2.1 还原项目
1)管理员登录运维平台,选择待还原的项目,点击「维护>备份管理」。
2)在「全部备份」中,找到待还原的文件,点击「还原」按钮。
3)提示「还原过程将持续一段时间,期间被还原项目无法使用,是否确定还原?」,点击「确认」按钮后开始还原
2.2 异常情况
正常情况下,用户只需要耐心等待项目还原成功即可。但如出现以下情况,将无法正常还原,需要进行排查/额外配置。
2.2.1 缺失24小时内备份
问题描述:还原失败,提示:还原前请保证至少有24小时内的备份,当前项目最近备份时间为XXXXX,请备份后重试
原因分析:若还原时项目可用,必须存在24小时内的新备份,方可使用其他备份进行还原,确保一旦还原出现问题,仍可使用新备份回退工程。
解决方案:请在还原前,对项目进行完整备份操作。详情请参见:备份项目
2.2.2 缺失组件镜像
问题描述:还原失败,提示:未找到所需要xxx镜像,请获取对应镜像并推送至镜像仓库后重试
原因分析:还原时,检测发现不存在备份对应版本的镜像,则还原失败
解决方案:
1)付费用户请联系帆软技术支持,获取指定版本镜像包。技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」。
2)参考文档推送至仓库:手动推送镜像入库
2.2.3 缺失项目节点
问题描述:
还原时提示:当前项目节点数少于备份节点数。请确认各节点ops_agent是否启动,或通过新增节点进行还原
排查步骤1:项目中部分节点的ops_agent组件未启动,则无法正常还原
在运维平台中选择该项目,点击「维护>组件管理」。
找到「ops_agent」组件,通过点击「重启」,确保容器状态全部「running」。
排查步骤2:当前项目节点数量少于备份时的项目节点数量,需要新增节点方可还原。
点击「新增节点」,进入节点配置界面,会提示「当前缺失x个主应用类型节点、x个组件类型节点」
点击「+新增节点」,按照需求增加足够的节点数量。点击「确定」。此时即可继续还原。
注1:新增的服务器,与部署项目时的服务器要求一致,可参考:部署新项目
注2:新增的服务器,必须是干净的服务器,若检测到该服务器中存在ops_agent组件,则认定该服务器中已部署了其他项目。
还原失败,提示:还原失败,指定节点已存在此项目的ops_agent,请启动后还原
注3:若缺失的节点,包含集群组件所在的节点,还原成功后需要重新配置集群。可参考:配置开启集群
2.3.4 多余项目节点
问题描述:还原失败,提示:当前项目节点数多于备份节点数,无法通过此备份进行还原,请停用多余节点或使用其他备份重试
原因分析:在备份之后,项目新增了节点,导致备份与当前状态不一致,无法直接还原
解决方案:建议不要采用此备份进行还原。
如果非常需要进行还原,付费用户请联系帆软技术支持协助。技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」。
3. 还原非运维平台部署的项目
非运维平台部署的项目,不支持通过前端界面化一键还原。本章讲述手动还原的方法。
3.1 还原前备份
由于备份的文件,依赖项目以外的一些配置,因此可能会还原失败。(例如embed还原前提,必须确保原始外置库可用)
因此建议在还原前,对项目进行完整备份操作,或对服务器打快照。详情请参见:备份项目
3.2 查找备份文件
1)管理员登录运维平台,选择待还原的项目,点击「维护>备份管理」。
2)在「全部备份」中,找到待还原的文件,点击复制「备份目录名」。
3)使用终端登录运维平台所在服务器,进入/运维平台挂载目录/ops/resources/backup文件夹,找到上文的备份目录。
其中存储的,即为该备份的项目文件。
3.3 还原项目
1)关闭工程节点
请参考 关闭或重启FineReport工程 文档,关闭单机工程节点/集群每一个工程节点。
2)还原工程文件
请将上节找到的文件,还原到每个工程节点/文件服务器。
备份文件 | 还原位置 | 说明 |
---|---|---|
assets | 单机:/webroot/WEB-INF/assets 集群:文件服务器/assets | 通用的共享持久化目录、FineReport模板备份文件、工程读写(图片)缓存 |
reportlets | 单机:/webroot/WEB-INF/reportlets 集群:文件服务器/reportlets | FineReport模板存放目录 |
resources | 单机:/webroot/WEB-INF/resources 集群:文件服务器/resources | 注册文件,模板加密文件 |
classes | 单机:/webroot/WEB-INF/classes 集群:各工程节点/webroot/WEB-INF/classes | 工程调用的默认和自定义class文件 |
config | 单机:/webroot/WEB-INF/config 集群:各工程节点/webroot/WEB-INF/config | 平台调用的配置库(finedb)存储信息 |
embed | 单机:/webroot/WEB-INF/embed 集群:各工程节点/webroot/WEB-INF/embed | 存放着工程曾经/现在使用的内置finedb数据库(即使现在使用着外接配置库,也建议拷贝,方便回退) |
plugins | 单机:/webroot/WEB-INF/plugins 集群:各工程节点/webroot/WEB-INF/plugins | 插件相关文件 |
3)重启工程节点
参考 关闭或重启FineReport工程 文档,重启单机工程节点/集群每一个工程节点,恢复正常运行。