附录 A. OCF 返回代码
本附录描述了 OCF 返回代码,以及如何由 Pacemaker 解释它们。
当代理返回代码时,集群要做的第一件事是针对预期结果检查返回代码。如果结果与预期值不匹配,则操作被视为失败,并启动恢复操作。
对于任何调用,资源代理必须以定义的返回代码退出,该代码告知调用者调用的操作的结果。
如 表 A.1 “集群恢复执行的类型” 所述,有三种类型的故障恢复。
类型 | 描述 | 集群抓取的操作 |
---|---|---|
soft
|
发生瞬态错误.
|
重新启动资源 或将其移到新位置。
|
难
|
发生非临时错误,可能特定于当前节点。
|
将资源移到其他位置,并阻止其在当前节点上重试。
|
fatal
|
发生非临时错误,适用于所有集群节点(例如,指定了一个错误的配置)。
|
停止资源,并阻止其在任何群集节点上启动。
|
表 A.2 “OCF 返回代码” 提供 OCF 返回代码,以及群集在收到失败代码时将启动的恢复类型。请注意,如果 0 不是预期返回值,即使返回 0(OCF 别名
OCF 别名 OCF_SUCCESS
)的操作也被视为失败。
返回代码 | OCF Label | 描述 | |||
---|---|---|---|---|---|
0
| OCF_SUCCESS
|
| |||
1
| OCF_ERR_GENERIC
|
| |||
2
| OCF_ERR_ARGS
|
| |||
3
| OCF_ERR_UNIMPLEMENTED
|
| |||
4
| OCF_ERR_PERM
|
| |||
5
| OCF_ERR_INSTALLED
|
| |||
6
| OCF_ERR_CONFIGURED
|
| |||
7
| OCF_NOT_RUNNING
|
| |||
8
| OCF_RUNNING_MASTER
|
| |||
9
| OCF_FAILED_MASTER
|
| |||
其他
|
不适用
|
自定义错误代码.
|