还原项目

1.1 版本

1.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，请启动后还原

• 节点全部添加完毕后，点击「确定」，即可自动开始还原项目

注：若缺失的节点，包含集群组件所在的节点，还原成功后需要重新配置集群。可参考：配置开启集群

2.3.4 多余项目节点

问题描述：还原失败，提示：当前项目节点数多于备份节点数，无法通过此备份进行还原，请停用多余节点或使用其他备份重试

原因分析：在备份之后，项目新增了节点，导致备份与当前状态不一致，无法直接还原

解决方案：建议不要采用此备份进行还原。

如果非常需要进行还原，付费用户请联系帆软技术支持协助。技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。

非运维平台部署的项目，不支持通过前端界面化一键还原。本章讲述手动还原的方法。

3.1 还原前备份

由于备份的文件，依赖项目以外的一些配置，因此可能会还原失败。（例如embed还原前提，必须确保原始外置库可用）

因此建议在还原前，对项目进行完整备份操作，或对服务器打快照。详情请参见：备份项目

3.2 查找备份文件

1）管理员登录运维平台，选择待还原的项目，点击「维护>备份管理」。

2）在「全部备份」中，找到待还原的文件，点击复制「备份目录名」。

3）使用终端登录运维平台所在服务器，进入/运维平台挂载目录/ops/resources/backup文件夹，找到上文的备份目录。

其中存储的，即为该备份的项目文件。

3.3 还原项目

1）关闭工程节点

请参考 关闭或重启FineReport工程 文档，关闭单机工程节点/集群每一个工程节点。

2）还原工程文件

请将上节找到的文件，还原到每个工程节点/文件服务器。

3）重启工程节点

参考 关闭或重启FineReport工程 文档，重启单机工程节点/集群每一个工程节点，恢复正常运行。