Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

附录 A. OCF 返回代码

本附录描述了 OCF 返回代码，以及如何由 Pacemaker 解释它们。
当代理返回代码时，集群要做的第一件事是针对预期结果检查返回代码。如果结果与预期值不匹配，则操作被视为失败，并启动恢复操作。
对于任何调用，资源代理必须以定义的返回代码退出，该代码告知调用者调用的操作的结果。
如 表 A.1 “集群恢复执行的类型” 所述，有三种类型的故障恢复。

表 A.1. 集群恢复执行的类型

类型描述集群抓取的操作
soft
发生瞬态错误.
重新启动资源 或将其移到新位置。
难
发生非临时错误，可能特定于当前节点。
将资源移到其他位置，并阻止其在当前节点上重试。
fatal
发生非临时错误，适用于所有集群节点（例如，指定了一个错误的配置）。
停止资源，并阻止其在任何群集节点上启动。
表 A.2 “OCF 返回代码” 提供 OCF 返回代码，以及群集在收到失败代码时将启动的恢复类型。请注意，如果 0 不是预期返回值，即使返回 0（OCF 别名 OCF 别名 OCF_SUCCESS）的操作也被视为失败。

表 A.2. OCF 返回代码

返回代码OCF Label描述
0
OCF_SUCCESS
该操作成功完成。这是任何成功启动、停止、提升和降级命令的预期返回代码。
如果意外： soft 则键入
1
OCF_ERR_GENERIC
该操作返回一个通用错误。
类型：软
资源管理器将尝试恢复资源或将其移动到新位置。
2
OCF_ERR_ARGS
资源的配置在此计算机上无效。例如，它引用节点上未找到的位置。
类型： hard
资源管理器将在其他位置移动资源，并阻止其在当前节点上重试
3
OCF_ERR_UNIMPLEMENTED
请求的操作未实施。
类型： hard
4
OCF_ERR_PERM
资源代理没有足够的特权来完成该任务。这可能是因为代理无法打开特定文件、侦听特定套接字或写入目录。
类型： hard
除非另有特殊配置，否则资源管理器将通过在其他节点上重启资源来尝试恢复出错的资源（其中权限问题可能不存在）。
5
OCF_ERR_INSTALLED
执行该操作的节点上缺少所需的组件。这可能是因为所需的二进制文件不可执行，或者重要配置文件不可读取。
类型： hard
除非另有特殊配置，否则资源管理器将尝试通过在其他节点上重启资源（可能存在所需的文件或二进制文件）来恢复发生此错误的资源。
6
OCF_ERR_CONFIGURED
本地节点上的资源配置无效。
类型：fatal
当返回此代码时，Pacemaker 将阻止资源在集群中的任何节点上运行，即使服务配置在某些其他节点上有效。
7
OCF_NOT_RUNNING
资源已被安全停止。这意味着资源已正常关闭，或者从未启动。
如果意外： soft 则键入
对于任何操作，集群不会尝试停止返回此值的资源。
8
OCF_RUNNING_MASTER
资源在 master 模式下运行。
如果意外： soft 则键入
9
OCF_FAILED_MASTER
资源处于 master 模式，但失败。
类型：软
资源将被降级、停止，然后再次启动（可能升级）。
其他
不适用
自定义错误代码.