OCF资源脚本书写方法

最新推荐文章于 2018-11-20 14:58:30 发布
最新推荐文章于 2018-11-20 14:58:30 发布
阅读量1.3k 收藏 1
点赞数
分类专栏： ha 文章标签： awk
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/trtra/article/details/84904990
版权

本文为转载，原文地址：http://www.cnblogs.com/haohao-jishuzhilu/archive/2012/12/18/2823271.html

Open Cluster Framework (OCF) 资源代理

OCF RA 代理最适合用于 High Availability，特别是在您需要主资源或特殊监视功能时。这些代理通常位于 /usr/lib/ocf/resource.d/heartbeat/。其功能与 LSB 脚本的功能相似。但是，它们始终使用环境变量来执行配置，这使它们可以轻松地接受和处理参数。OCF 规范（由于它与资源代理相关）可在http://www.opencf.org/cgi-bin/viewcvs.cgi/specs/ra/resource-agent-api.txt?rev=HEAD 4 中找到。OCF 规范包含以下严格定义：操作必须返回退出代码。群集会严格遵守这些规范。有关详细信息，请参见 http://wiki.linux-ha.orgOCFResourceAgent。

OCF 返回代码

根据 OCF 规范，有一些关于操作必须返回的退出代码的严格定义。群集会始终

检查返回代码与预期结果是否相符。如果结果与预期值不匹配，则将操作视为

失败，并将启动恢复操作。

在实际应用中，如果要对某一个资源是否正常进行监控，可以根据ocf提供的一个虚设资源代理Dummy进行修改即可。

ocf:Dummy — 虚设资源代理

OCF_RESKEY_state=string Dummy [start | stop | monitor | reload | migrate_to |migrate_from | meta-data | validate-all]

这是虚设资源代理。它只跟踪是否在运行，不执行其他任何操作。它在运行中的作用是测试并用作 RA 编写程序的模板。

支持的参数：OCF_RESKEY_state=状态文件，即储存资源状态的位置。

"${HA_VARRUN}/Dummy-${OCF_RESOURCE_INSTANCE}.state"  , 一般在/usr/var/run/下

Eg: /usr/var/run/Dummy-example-check.state，example-check是ocf资源实例的名字，在heartbeat中进行设置即可。

ResourceManager 可以根据这个资源状态文件，来判断被监控的资源状态，从而做出各种判断。

Ocf:Dummy的位置一般在 /usr/lib/ocf/resource.d/pacemaker/Dummy

OCF格式的脚本的写法

这里只提供一种比较简单的方式。

HealthCPU是以Dummy为模板的监控cpu状态的ocf资源监控脚本，也是pacemaker提供的，位置一般在

/usr/lib/ocf/resource.d/pacemaker/HealthCPU

通过分析这个脚本，我们就可以触类旁通的了解ocf格式的脚本

#!/bin/sh  

#   HealthCPU OCF RA. Measures CPUs ideling and writes

#   #health-cpu status into the CIB

#...

# Inc., 59 Temple Place - Suite 330, Boston MA 02111-1307, USA.

#######################################################################

# Initialization://初始化一些ocf资源通用的一些函数资源等

. ${OCF_ROOT}/resource.d/heartbeat/.ocf-shellfuncs

#######################################################################

//metadata 转储resource agent 的元数据到标准输出，这个输出必须遵循一定的格式，//具体的格式参见：http://www.linux-ha.org/doc/dev-guides/_metadata.html

//所有的resource agent 都必须通过一组特定的XML格式的元数据，来描述自己的目标，//以及所支持的参数等，集群管理应用需要这些元数据来提供on-line help，而且//resource agent的操作说明（man pages）也是根据这个元数据来生成的。

meta_data() {

    cat <<END

<?xml version="1.0"?>

<!DOCTYPE resource-agent SYSTEM "ra-api-1.dtd">

<resource-agent name="HealthCPU" version="0.1">//HealthCPU是资源名称

<version>0.1</version>

 

<longdesc lang="en">

Systhem health agent that measures the CPU ideling and updates the #health-cpu attribute.//监控资源说明

</longdesc>

<shortdesc lang="en">System health CPU usage</shortdesc>

 

<parameters>

<parameter name="state" unique="1">// unique (可选的值: 0 或者 1) 表明对于一个特定的资源类型，一个特殊的值必须在集群中唯一. 例如, 一个高可用性的浮动IP地址 需要声明unique — 因为一个IP地址应该在集群中应该唯一

<longdesc lang="en">

Location to store the resource state in.

</longdesc>

<shortdesc lang="en">State file</shortdesc>

<content type="string" default="${HA_VARRUN}/health-cpu-{OCF_RESOURCE_INSTANCE}.state" />//这里是监控资源状态文件的地址和名称，可以直接只将health-cpu改为要监控的资源名

</parameter>

//下面的参数是表示判断资源状态的阈值，yellow-limit，red-limit，可以根据资源状态来划分资源运行中出错的等级，还可以再设定其他的资源状态阈值来标识资源的状态，如果资源的状态不是一个数值，可以对资源状态进行评分，然后根据这些阈值来判断状态。当然也可以不设置这些阈值，在监控的时候，当资源正常时直接将状态标记为green，当资源出错时直接标记为yellow 或者red或者failed等。

<parameter name="yellow_limit" unique="1">

<longdesc lang="en">

Lower (!) limit of idle percentage to switch the health attribute to yellow. I.e.

the #health-cpu will go yellow if the %idle of the CPU falls below 50%.

</longdesc>

<shortdesc lang="en">Lower limit for yellow health attribute</shortdesc>

<content type="string" default="50"/>//yellow-limit的类型是string，默认值是50

</parameter>

 

<parameter name="red_limit" unique="1">

<longdesc lang="en">

Lower (!) limit of idle percentage to switch the health attribute to red. I.e.

the #health-cpu will go red if the %idle of the CPU falls below 10%.

</longdesc>

<shortdesc lang="en">Lower limit for red health attribute</shortdesc>

<content type="string" default="10"/>

</parameter>

</parameters>

//监控脚本所支持的参数，是资源监控代理所支持的动作参数，必须支持的有start、stop、monitor、meta-data、validate-all，可选的有promote、demote、migrate_to、 migrate_from 、notify。这里给出建议的timeout等的值

<actions>

<action name="start"        timeout="10" />  //starts the resource，timeout单位是秒

<action name="stop"         timeout="10" />//  shuts down the resource.

<action name="monitor"      timeout="10" interval="10" start-delay="0" />//查询资源运行的状态

<action name="meta-data"    timeout="5" />// dumps the resource agent metadata.

<action name="validate-all"   timeout="10" />//确认资源的配置

</actions>

</resource-agent>

END

}

#######################################################################

dummy_usage() {

    cat <<END

usage: $0 {start|stop|monitor|validate-all|meta-data}

Expects to have a fully populated OCF RA-compliant environment set.

END

}

//开启资源监控

dummy_start() {

//这里的cpu资源不需要启动，但是如果是一个应用资源，那么就需要在这里启动这个应用资源，使应用跑起来，然后再监控应用的状态

 dummy_monitor

    if [ $? =  $OCF_SUCCESS ]; then

    return $OCF_SUCCESS

    fi

    touch ${OCF_RESKEY_state}//创建资源状态文件

}

//停止资源监控

dummy_stop() {

    dummy_monitor

    if [ $? =  $OCF_SUCCESS ]; then

    rm ${OCF_RESKEY_state}

//这里的cpu资源不需要关闭，但是如果是一个应用资源，那么就需要在这里关闭这个应用资源，使应用停止

    fi

    return $OCF_SUCCESS

}

//监控资源状态

dummy_monitor() {

    # Monitor _MUST!_ differentiate correctly between running

    # (SUCCESS), failed (ERROR) or _cleanly_ stopped (NOT RUNNING).

    # That is THREE states, not just yes/no.

   

    if [ -f ${OCF_RESKEY_state} ]; then

                    向下：

     

      IDLE=`top -b -n2 | grep Cpu | tail -1 | awk -F",|\.[0-9]%id" '{ print $4 }'`//得到系统的cpu空闲率

 

      if [ $IDLE -lt ${OCF_RESKEY_red_limit} ] ; then

        # echo "System state RED!"

        attrd_updater -n "#health-cpu" -U "red" -d "30s"//更新cpu状态，将状态写入cpu资源状态文件

        return $OCF_SUCCESS

          fi

 

      if [ $IDLE -lt ${OCF_RESKEY_yellow_limit} ] ; then

        # echo "System state yellow."

            attrd_updater -n "#health-cpu" -U "yellow" -d "30s"//持续30s都是这个情况，则将状态改变

      else

        # echo "System state green."

        attrd_updater -n "#health-cpu" -U "green" -d "30s"

          fi

      return $OCF_SUCCESS

 

    fi

      向上                                       

这一部分是监控资源状态的代码，即如果系统cpu超过预设的阈值，则将状态写入资源状态文件，是监控的主要代码。如果是一个应用的监控，则需要check它是否运行正常，然后把它的状态情况写入资源状态文件。

    if false ; then

                return $OCF_ERR_GENERIC

        fi

        return $OCF_NOT_RUNNING//资源监控已经停止了

}

dummy_validate() {

    # Is the state directory writable?

    state_dir=`dirname "$OCF_RESKEY_state"`

    touch "$state_dir/$$"

    if [ $? != 0 ]; then

    return $OCF_ERR_ARGS

    fi

    rm "$state_dir/$$"

    return $OCF_SUCCESS

}

 

: ${OCF_RESKEY_CRM_meta_interval=0}

: ${OCF_RESKEY_CRM_meta_globally_unique:="true"}

//下面设置资源状态文件

if [ "x$OCF_RESKEY_state" = "x" ]; then

    if [ ${OCF_RESKEY_CRM_meta_globally_unique} = "false" ]; then

    state="${HA_VARRUN}/Dummy-${OCF_RESOURCE_INSTANCE}.state"

   

    # Strip off the trailing clone marker

    OCF_RESKEY_state=`echo $state | sed s/:[0-9][0-9]*\.state/.state/`

    else

    OCF_RESKEY_state="${HA_VARRUN}/Dummy-${OCF_RESOURCE_INSTANCE}.state"

    fi

fi

//预设了cpu状态阈值

if [ "x${OCF_RESKEY_red_limit}" = "x" ] ; then

  OCF_RESKEY_red_limit=10

fi

if [ "x${OCF_RESKEY_yellow_limit}" = "x" ] ; then

  OCF_RESKEY_yellow_limit=50

fi

 

case $__OCF_ACTION in

meta-data) meta_data

       exit $OCF_SUCCESS

       ;;

start)     dummy_start;;

stop)      dummy_stop;;

monitor)   dummy_monitor;;

validate-all) dummy_validate;;

usage|help)   dummy_usage

       exit $OCF_SUCCESS

       ;;

*)     dummy_usage

       exit $OCF_ERR_UNIMPLEMENTED

       ;;

esac

rc=$?

ocf_log debug "${OCF_RESOURCE_INSTANCE} $__OCF_ACTION : $rc"

exit $rc

 

根据这个例子，可以看出，我们监控某个程序的时候，可以检测后，将它的状态写入资源状态文件，通过这个文件将资源的状态传给资源管理器，从而得到监控资源的目的。 

trtra
关注
专栏目录
Pacemaker OCF 资源
Mr_Liweijin的博客
01-14 1420
 Pacemaker / Corosync 是 Linux 下一组常用的高可用集群系统。Pacemaker 本身已经自带了很多常用应用的管理功能。但是如果要使用 Pacemaker 来管理自己实现的服务或是一些别的没现成的东西可用的服务时，就需要自己实现一个资源了。 Pacemaker 的资源主要有两类，即 LSB 和 OCF。其中 LSB 即 Linux 标准服务，通常就是 /etc/i
pacemaker的启动脚本
gzhouc的专栏
11-20 2478
启动脚本都放在了/uer/lib/ocf/resource.d下面。 如果全用的fuel安装的openstack,启动脚本在/usr/lib/ocf/resource.d/fuel下面。 pacemaker所管理的网桥的相关信息放在了： /sys/class/net/ 并且这个目录下的虚IP的相关的文件是pacemaker在启动的时候动态生成的。
自定义 Pacemaker OCF 资源（转）
Better Me的博客
12-03 9295
Pacemaker / Corosync 是 Linux 下一组常用的高可用集群系统。Pacemaker 本身已经自带了很多常用应用的管理功能。但是如果要使用 Pacemaker 来管理自己实现的服务或是一些别的没现成的东西可用的服务时，就需要自己实现一个资源了。 Pacemaker 的资源主要有两类，即 LSB 和 OCF。其中 LSB 即 Linux 标准服务，通常就是 /etc/ini
自定义pacemaker监控脚本-iscsi卷自动挂载
weixin_33901843的博客
07-06 427
2019独角兽企业重金招聘Python工程师标准>>> ...
scst-fc-ra:用于管理SCST Qlogic光纤通道MPIO目标的OCF资源代理-开源
05-08
资源代理，可以管理通过Qlogic光纤通道卡和开源通用SCSI目标SCST实现的光纤通道目标。 使用此资源代理，您可以在HBA上运行多个NPIV光纤通道目标实例。 您最多可以使用1个255个HBA进行多路径处理。 RA将按照配置创建...
OCF-Architecture-Introduction
12-23
OCF定义了两种主要的设备发现方法：基于IETF的CoAP发现（CoAP Discovery）和资源目录（Resource Directory）。 8. 编码方案（EncodingSchemes）： OCF规范采用了CBOR（Concise Binary Object Representation）作为...
resource-agents:RHCS和Linux-HA项目中的OCF代理的组合存储库
05-12
该存储库包含符合开放式集群框架（OCF）规范的资源代理（RA）。 这些资源代理由两个群集资源管理实现使用： 起搏器 管理员 《 OCF资源代理开发人员指南》（下面的链接）中提供了有关OCF资源代理的更多信息。 在...
ocfweb：ocf主要网站
02-01
网页 在ocfweb工作 我们建议在人员登录服务器执行所有这些步骤，因为它已经配置为以最少的额外设置在... 如果您从ocfweb的分支向OCF GitHub组织提出拉取请求，Jenkins将尝试自动构建和测试您的分支。 如果您的构建失
树莓派上运行第一个OCF程序
07-23
"树莓派上运行第一个OCF程序" 本文将指导读者在树莓派上运行第一个OCF程序，介绍了OCF入门级的物联网协议，并将其应用于树莓派上。本文将分步骤指导读者完成整个过程，从初始化树莓派到运行OCF程序。 _step 1：...
EPUB OCF_2.0.1 规范
04-16
EPUB OCF（Open Container Format）2.0.1 v1.0.1 规范，英文版 。
OCF 相关(一)
u012385733的专栏
07-20 2076
OpenBSD Cryptographic Framework(OCF) 一．OCF 介绍 当今的计算机系统包括很多的应用，而在点对点通信的应用中，通常会包含很多敏感的信息．那么就需要利用加密机制来保护这些信息，但是加密算法设计的非常复杂和消耗CPU时间．从而导致整个系统性能的降低． 对于上面的缺陷，很多应用为了更好的性能而放弃加密，因为加密算法常常是软件实现的．为了解决这个问题，产商也生产...
pacemaker命令小记
tianyuanmax的专栏
05-06 1464
pacemaker一些命令及解释 crm --help crm configure show 查看配置 crm_mon --version 查看版本 crm configure primitive ClusterIP ocf:heartbeat:IPaddr2 \ params ip=192.168.122.101 cidr_netmask=32 \ op monitor
Pacemaker中的资源管理工具--CRM基本指令及用法
weixin_34306446的博客
10-22 1098
配置pacemaker有2种途径，一是命令行工具包括crm和pcs，二是图形工具包括：pygui(mgmt),Hawk,LCMC,pcsd.mgmt出道时间较早，很多文章有介绍；LCMC是Java编写的图形管理工具；Hawk则是官方推荐的代替mgmt的web界面配置工具；pcsd则是pcs的图形界面。具体可参考http://clusterlabs.org/#addons 本...
/var/run目录详解
灬紫荆灬
11-20 7433
/var/run是干什么用的 根据linux的文件系统分层结构标准（FHS）中的定义：/var/run 目录中存放的是自系统启动以来描斜体样式述系统信息的文件。比较常见的用途是daemon进程将自己的pid保存到这个目录。标准要求这个文件夹中的文件必须是在系统启动的时候清空，以便建立新的文件。 为了达到这个要求，linux中/var/run使用的是tmpfs文件系统，这是一种存储在内存中的临时文件...
OCF文件解析过程
面向痛苦的编程
12-05 2062
参阅文档OMA-Download-DRMCF-V1_0-20040615-A.pdf和程序验证，已经利用java程序成功解析经过DRM加密的dcf文件。 dcf字节流解析： dcf规范版本               1 byte    值始终为1 ContentType长度           1 byte    ContentType长度 ContentURL长度
epub格式电子书剖析
热门推荐
不以己悲的博客
11-16 2万+
<br />    epub格式电子书遵循IDPF推出的OCF规范，OCF规范遵循ZIP压缩技术，即epub电子书本身就是一个ZIP文件，我们将epub格式电子书的后缀.epub修改为.zip后，可以通过解压缩软件（例如winrar、winzip）进行浏览或解压处理。一个未经加密处理的epub电子书以三个部分组成，其文件结构如下图所示：<br />   <br />    1、文件：mimetype<br />    每一本epub电子书均包含一个名为mimetype的文件，且内容不变，用以说明epub的文
corosync基本使用
weixin_30929295的博客
06-30 2978
相关rpm: corosync-2.4.0-4.el6.x86_64.rpm　　　　　　　　　　　　　The Corosync Cluster Engine and Application Programming Interfaces。 corosynclib-2.4.0-4.el6.x86_64.rpm　　　　　　　　　　　　The Corosync Cluster Engine L...
pacemaker的lsb资源脚本读取xml
最新发布
06-08
在 Pacemaker 中，可以使用 lsb 资源代理来管理系统服务。在 lsb 资源脚本中，可以使用 xml 配置文件来定义资源的属性和操作。 以下是一个示例 xml 配置文件： ``` <resource-agent name="my-resource" version="1.0"> <longdesc lang="en"> This is a custom resource agent for managing my resource. </longdesc> <shortdesc lang="en"> My Resource Agent </shortdesc> <parameters> <parameter name="my_param" unique="1" required="1"> <longdesc lang="en"> This is my parameter. </longdesc> <shortdesc lang="en"> My Parameter </shortdesc> <content type="string"/> </parameter> </parameters> <actions> <action name="start" timeout="20" interval="0"> <longdesc lang="en"> This action starts my resource. </longdesc> <shortdesc lang="en"> Start </shortdesc> <script><![CDATA[ #!/bin/bash echo "Starting my resource with parameter $OCF_RESKEY_my_param" # Add your start command here ]]></script> </action> <action name="stop" timeout="20" interval="0"> <longdesc lang="en"> This action stops my resource. </longdesc> <shortdesc lang="en"> Stop </shortdesc> <script><![CDATA[ #!/bin/bash echo "Stopping my resource" # Add your stop command here ]]></script> </action> </actions> </resource-agent> ``` 在这个示例中，xml 配置文件定义了一个名为 "my-resource" 的资源代理，它包含一个名为 "my_param" 的参数和两个操作："start" 和 "stop"。 在 lsb 资源脚本中，可以使用以下命令来读取 xml 配置文件： ``` OCF_RESKEY_my_param=`xmlstarlet sel -t -v \ "//parameter[@name='my_param']/content" \ /etc/ha.d/resource.d/my-resource.xml` ``` 这个命令使用 xmlstarlet 工具来选择 xml 文件中名为 "my_param" 的参数，并将其值赋给环境变量 "OCF_RESKEY_my_param"。 类似地，可以使用 xmlstarlet 来选择操作的脚本，并在 lsb 脚本中执行它们。 注意：在 lsb 脚本中使用 xmlstarlet 可能需要先安装 xmlstarlet 工具。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值