diff --git a/doc/Makefile.am b/doc/Makefile.am index c119e9143..ee3b3f9fc 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,158 +1,159 @@ # # doc: Linux-HA resource agents # # Copyright (C) 2009 Florian Haas # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation; either version 2 # of the License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. # MAINTAINERCLEANFILES = Makefile.in EXTRA_DIST = $(doc_DATA) $(REFENTRY_STYLESHEET) \ mkappendix.sh ralist.sh CLEANFILES = $(man_MANS) $(xmlfiles) metadata-*.xml doc_DATA = README.webapps STYLESHEET_PREFIX ?= http://docbook.sourceforge.net/release/xsl/current MANPAGES_STYLESHEET ?= $(STYLESHEET_PREFIX)/manpages/docbook.xsl HTML_STYLESHEET ?= $(STYLESHEET_PREFIX)/xhtml/docbook.xsl FO_STYLESHEET ?= $(STYLESHEET_PREFIX)/fo/docbook.xsl REFENTRY_STYLESHEET ?= ra2refentry.xsl XSLTPROC_OPTIONS ?= --xinclude XSLTPROC_MANPAGES_OPTIONS ?= $(XSLTPROC_OPTIONS) XSLTPROC_HTML_OPTIONS ?= $(XSLTPROC_OPTIONS) XSLTPROC_FO_OPTIONS ?= $(XSLTPROC_OPTIONS) radir = $(top_srcdir)/heartbeat # OCF_ROOT=. is necessary due to a sanity check in ocf-shellfuncs # (which tests whether $OCF_ROOT points to a directory metadata-%.xml: $(radir)/% OCF_ROOT=. OCF_FUNCTIONS_DIR=$(radir) $< meta-data > $@ metadata-IPv6addr.xml: ../heartbeat/IPv6addr OCF_ROOT=. OCF_FUNCTIONS_DIR=$(radir) $< meta-data > $@ # Please note: we can't name the man pages # ocf:heartbeat:. Believe me, I've tried. It looks like it # works, but then it doesn't. While make can deal correctly with # colons in target names (when properly escaped), it royally messes up # when it is deals with _dependencies_ that contain colons. See Bug # 12126 on savannah.gnu.org. But, maybe it gets fixed soon, it was # first reported in 1995 and added to Savannah in in 2005... if BUILD_DOC man_MANS = ocf_heartbeat_AoEtarget.7 \ ocf_heartbeat_AudibleAlarm.7 \ ocf_heartbeat_ClusterMon.7 \ ocf_heartbeat_CTDB.7 \ ocf_heartbeat_Delay.7 \ ocf_heartbeat_Dummy.7 \ ocf_heartbeat_EvmsSCC.7 \ ocf_heartbeat_Evmsd.7 \ ocf_heartbeat_Filesystem.7 \ ocf_heartbeat_ICP.7 \ ocf_heartbeat_IPaddr.7 \ ocf_heartbeat_IPaddr2.7 \ ocf_heartbeat_IPsrcaddr.7 \ ocf_heartbeat_LVM.7 \ ocf_heartbeat_LinuxSCSI.7 \ ocf_heartbeat_MailTo.7 \ ocf_heartbeat_ManageRAID.7 \ ocf_heartbeat_ManageVE.7 \ ocf_heartbeat_Pure-FTPd.7 \ ocf_heartbeat_Raid1.7 \ ocf_heartbeat_Route.7 \ ocf_heartbeat_SAPDatabase.7 \ ocf_heartbeat_SAPInstance.7 \ ocf_heartbeat_SendArp.7 \ ocf_heartbeat_ServeRAID.7 \ ocf_heartbeat_SphinxSearchDaemon.7 \ ocf_heartbeat_Squid.7 \ ocf_heartbeat_Stateful.7 \ ocf_heartbeat_SysInfo.7 \ ocf_heartbeat_VIPArip.7 \ ocf_heartbeat_VirtualDomain.7 \ ocf_heartbeat_WAS.7 \ ocf_heartbeat_WAS6.7 \ ocf_heartbeat_WinPopup.7 \ ocf_heartbeat_Xen.7 \ ocf_heartbeat_Xinetd.7 \ ocf_heartbeat_anything.7 \ ocf_heartbeat_apache.7 \ ocf_heartbeat_conntrackd.7 \ ocf_heartbeat_db2.7 \ ocf_heartbeat_drbd.7 \ ocf_heartbeat_eDir88.7 \ ocf_heartbeat_ethmonitor.7 \ ocf_heartbeat_exportfs.7 \ ocf_heartbeat_fio.7 \ ocf_heartbeat_iSCSILogicalUnit.7 \ ocf_heartbeat_iSCSITarget.7 \ ocf_heartbeat_ids.7 \ ocf_heartbeat_iscsi.7 \ ocf_heartbeat_jboss.7 \ ocf_heartbeat_lxc.7 \ ocf_heartbeat_mysql.7 \ ocf_heartbeat_mysql-proxy.7 \ + ocf_heartbeat_named.7 \ ocf_heartbeat_nfsserver.7 \ ocf_heartbeat_nginx.7 \ ocf_heartbeat_oracle.7 \ ocf_heartbeat_oralsnr.7 \ ocf_heartbeat_pgsql.7 \ ocf_heartbeat_pingd.7 \ ocf_heartbeat_portblock.7 \ ocf_heartbeat_postfix.7 \ ocf_heartbeat_proftpd.7 \ ocf_heartbeat_rsyncd.7 \ ocf_heartbeat_scsi2reservation.7 \ ocf_heartbeat_sfex.7 \ ocf_heartbeat_symlink.7 \ ocf_heartbeat_syslog-ng.7 \ ocf_heartbeat_tomcat.7 \ ocf_heartbeat_vmware.7 if USE_IPV6ADDR man_MANS += ocf_heartbeat_IPv6addr.7 endif xmlfiles = $(man_MANS:.7=.xml) %.1 %.5 %.7 %.8: %.xml $(XSLTPROC) \ $(XSLTPROC_MANPAGES_OPTIONS) \ $(MANPAGES_STYLESHEET) $< ocf_heartbeat_%.xml: metadata-%.xml $(srcdir)/$(REFENTRY_STYLESHEET) $(XSLTPROC) --novalid \ --stringparam package $(PACKAGE_NAME) \ --stringparam version $(VERSION) \ --output $@ \ $(srcdir)/$(REFENTRY_STYLESHEET) $< ocf_resource_agents.xml: $(xmlfiles) mkappendix.sh ./mkappendix.sh $(xmlfiles) > $@ %.html: %.xml $(XSLTPROC) \ $(XSLTPROC_HTML_OPTIONS) \ --output $@ \ $(HTML_STYLESHEET) $< xml: ocf_resource_agents.xml endif diff --git a/heartbeat/Makefile.am b/heartbeat/Makefile.am index dacf3bd88..cc7baac9f 100644 --- a/heartbeat/Makefile.am +++ b/heartbeat/Makefile.am @@ -1,123 +1,124 @@ # Makefile.am for OCF RAs # # Author: Sun Jing Dong # Copyright (C) 2004 IBM # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation; either version 2 # of the License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. # MAINTAINERCLEANFILES = Makefile.in EXTRA_DIST = $(ocf_SCRIPTS) $(ocfcommon_DATA) \ $(common_DATA) $(hb_DATA) $(dtd_DATA) \ README INCLUDES = -I$(top_srcdir)/include -I$(top_srcdir)/linux-ha ocfdir = $(OCF_RA_DIR_PREFIX)/heartbeat dtddir = $(datadir)/$(PACKAGE_NAME) dtd_DATA = ra-api-1.dtd if USE_IPV6ADDR ocf_PROGRAMS = IPv6addr else ocf_PROGRAMS = endif IPv6addr_SOURCES = IPv6addr.c IPv6addr_LDADD = -lplumb $(LIBNETLIBS) ocf_SCRIPTS = ClusterMon \ CTDB \ Dummy \ IPaddr \ IPaddr2 \ drbd \ anything \ AoEtarget \ apache \ nginx \ AudibleAlarm \ conntrackd \ db2 \ Delay \ eDir88 \ EvmsSCC \ Evmsd \ ethmonitor \ exportfs \ Filesystem \ fio \ ids \ iscsi \ ICP \ IPsrcaddr \ iSCSITarget \ iSCSILogicalUnit \ jboss \ LinuxSCSI \ LVM \ lxc \ MailTo \ ManageRAID \ ManageVE \ mysql \ mysql-proxy \ + named \ nfsserver \ oracle \ oralsnr \ pingd \ portblock \ postfix \ pgsql \ proftpd \ Pure-FTPd \ Raid1 \ Route \ rsyncd \ SAPDatabase \ SAPInstance \ SendArp \ ServeRAID \ SphinxSearchDaemon \ Squid \ Stateful \ SysInfo \ scsi2reservation \ sfex \ symlink \ syslog-ng \ tomcat \ VIPArip \ VirtualDomain \ vmware \ WAS \ WAS6 \ WinPopup \ Xen \ Xinetd ocfcommondir = $(OCF_LIB_DIR_PREFIX)/heartbeat ocfcommon_DATA = ocf-shellfuncs \ ocf-binaries \ ocf-directories \ ocf-returncodes \ apache-conf.sh \ http-mon.sh # Legacy locations hbdir = $(sysconfdir)/ha.d hb_DATA = shellfuncs diff --git a/heartbeat/named b/heartbeat/named new file mode 100755 index 000000000..8d15db6b8 --- /dev/null +++ b/heartbeat/named @@ -0,0 +1,433 @@ +#!/bin/sh +# +# Description: Manages a named (Bind) server as an OCF High-Availability +# resource +# +# Authors: Serge Dubrouski (sergeyfd@gmail.com) +# +# Copyright: 2011 Serge Dubrouski +# +# License: GNU General Public License (GPL) +# +############################################################################### +# Initialization: + +: ${OCF_FUNCTIONS_DIR=${OCF_ROOT}/lib/heartbeat} +. ${OCF_FUNCTIONS_DIR}/ocf-shellfuncs + +# Used binaries +RNDC="rndc" +HOST="host" + +#Defaults +OCF_RESKEY_named_default="/usr/sbin/named" +OCF_RESKEY_named_user_default=named +OCF_RESKEY_named_config_default="" +OCF_RESKEY_named_pidfile_default="/var/run/named/named.pid" +OCF_RESKEY_named_rootdir_default="" +OCF_RESKEY_named_options_default="" +OCF_RESKEY_named_keytab_file_default="" +OCF_RESKEY_monitor_request_default="localhost" +OCF_RESKEY_monitor_response_default="127.0.0.1" +OCF_RESKEY_monitor_ip_default="127.0.0.1" + +: ${OCF_RESKEY_named=${OCF_RESKEY_named_default}} +: ${OCF_RESKEY_named_user=${OCF_RESKEY_named_user_default}} +: ${OCF_RESKEY_named_config=${OCF_RESKEY_named_config_default}} +: ${OCF_RESKEY_named_pidfile=${OCF_RESKEY_named_pidfile_default}} +: ${OCF_RESKEY_named_rootdir=${OCF_RESKEY_named_rootdir_default}} +: ${OCF_RESKEY_named_options=${OCF_RESKEY_named_options_default}} +: ${OCF_RESKEY_named_keytab_file=${OCF_RESKEY_named_keytab_file_default}} +: ${OCF_RESKEY_monitor_request=${OCF_RESKEY_monitor_request_default}} +: ${OCF_RESKEY_monitor_response=${OCF_RESKEY_monitor_response_default}} +: ${OCF_RESKEY_monitor_ip=${OCF_RESKEY_monitor_ip_default}} + +usage() { + cat < + + +1.0 + + +Resource script for named (Bind) server. It manages named as an HA resource. + +Manages a named server + + + + +Path to the named command. + +named + + + + + +User that should own named process. + +named_user + + + + + +Configuration file for named. + +named_config + + + + + +PIDFILE file for named. + +named_pidfile + + + + + +Directory that named should use for chroot if any. + +named_rootdir + + + + + +Options for named process if any. + +named_options + + + + + +named service keytab file (for GSS-TSIG). + +named_keytab_file + + + + + +Request that shall be sent to named for monitoring. Usually an A record in DNS. + +monitor_request + + + + + +Expected response from named server. + +monitor_response + + + + + +IP Address where named listens. + +monitor_ip + + + + + + + + + + + + + + + + +EOF +} + +# +# methods: What methods/operations do we support? +# + +named_methods() { + cat </dev/null 2>&1 + if [ ! $? -eq 0 ]; then + ocf_log err "User $OCF_RESKEY_named_user doesn't exist"; + return $OCF_ERR_INSTALLED; + fi + + if [ -z "$OCF_RESKEY_monitor_request" -o \ + -z "$OCF_RESKEY_monitor_response" -o \ + -z "$OCF_RESKEY_monitor_ip" ]; then + ocf_log err "None of monitor_request, monitor_response, and monitor_ip can be empty" + return $OCF_ERR_CONFIGURED + fi + + return $OCF_SUCCESS +} + +# +# named_getpid. Get pid of named process with a given parameters. +# + +named_getpid () { + local pattern="$OCF_RESKEY_named" + + if [ -n "$OCF_RESKEY_named_rootdir" ]; then + pattern="$pattern.*-t $OCF_RESKEY_named_rootdir" + fi + + if [ -n "$OCF_RESKEY_named_config" ]; then + pattern="$pattern.*-c $OCF_RESKEY_named_config" + fi + + pid=`ps -e -o pid,command,args | grep "$pattern" | grep -v grep | awk '{print $1}'` + echo $pid +} + +# +# named_status. Simple check of the status of named process by pidfile. +# + +named_status () { + ocf_pidfile_status ${OCF_RESKEY_named_pidfile} >/dev/null 2>&1 +} + +# +# named_monitor. Send a request to named and check response. +# + +named_monitor() { + local output + + if ! named_status + then + ocf_log info "named is down" + return $OCF_NOT_RUNNING + fi + + output=`$HOST $OCF_RESKEY_monitor_request $OCF_RESKEY_monitor_ip` + + if [ $? -ne 0 ] || ! echo $output | grep -q '.* has address '"$OCF_RESKEY_monitor_response" + then + ocf_log err "named didn't answer properly for $OCF_RESKEY_monitor_request." + ocf_log err "Expected: $OCF_RESKEY_monitor_response." + ocf_log err "Got: $output" + return $OCF_ERR_GENERIC + fi + + return $OCF_SUCCESS +} + +# +# Reload +# + +named_reload() { + $RNDC reload >/dev/null || return $OCF_ERR_GENERIC + + return $OCF_SUCCESS +} + +# +# Start +# + +named_start() { + local root_dir_opt + local pid + + root_dir_opt="" + named_status && return $OCF_SUCCESS + + # Remove pidfile if exists + rm -f ${OCF_RESKEY_named_pidfile} + + if [ -n "${OCF_RESKEY_named_rootdir}" -a "x${OCF_RESKEY_named_rootdir}" != "x/" ] + then + root_dir_opt="-t ${OCF_RESKEY_named_rootdir}" + [ -s /etc/localtime ] && cp -fp /etc/localtime ${OCF_RESKEY_named_rootdir}/etc/localtime + fi + + if [ -n "$OCF_RESKEY_named_config" ]; then + OCF_RESKEY_named_options="-c $OCF_RESKEY_named_config $OCF_RESKEY_named_options" + fi + + if ! ${OCF_RESKEY_named} -u ${OCF_RESKEY_named_user} $root_dir_opt ${OCF_RESKEY_named_options} + then + ocf_log err "named failed to start." + return $OCF_ERR_GENERIC + fi + + + pid=`named_getpid` + + if [ -n "$pid" ]; then + if [ ! -e ${OCF_RESKEY_named_pidfile} ]; then + echo $pid > ${OCF_RESKEY_named_pidfile} + fi + else + ocf_log err "named failed to start. Probably error in configuration." + return $OCF_ERR_GENERIC + fi + + while : + do + named_monitor && break + sleep 1 + ocf_log debug "named hasn't started yet." + done + ocf_log info "named has started." + + return $OCF_SUCCESS +} + +# +# Stop +# + +named_stop () { + local timeout + + named_status || return $OCF_SUCCESS + + if ! $RNDC stop >/dev/null; then + kill `cat ${OCF_RESKEY_named_pidfile}` + fi + + if [ -n "$OCF_RESKEY_CRM_meta_timeout" ]; then + # Allow 2/3 of the action timeout for the orderly shutdown + # (The origin unit is ms, hence the conversion) + timeout=$((OCF_RESKEY_CRM_meta_timeout/1500)) + else + timeout=20 + fi + + while named_status ; do + if [ $timeout -ge ${OCF_RESKEY_named_stop_timeout} ]; then + break + else + sleep 1 + timeout=$((timeout++)) + fi + done + + #If still up + if named_status 2>&1; then + ocf_log err "named is still up! Killing"; + kill -9 `cat ${OCF_RESKEY_named_pidfile}` + fi + + rm -f ${OCF_RESKEY_named_pidfile} + return $OCF_SUCCESS +} + + +# Main part + +if [ $# -ne 1 ]; then + usage + exit $OCF_ERR_GENERIC +fi + +case "$1" in + methods) named_methods + exit $?;; + + meta-data) named_meta_data + exit $OCF_SUCCESS;; +esac + +named_validate_all +rc=$? + +[ "$1" == "validate-all" ] && exit $rc + +if [ $rc -ne 0 ] +then + case "$1" in + stop) exit $OCF_SUCCESS;; + monitor) exit $OCF_NOT_RUNNING;; + status) exit $OCF_NOT_RUNNING;; + *) exit $rc;; + esac +fi + +if [ "$EUID" != "0" ]; then + ocf_log err "$0 must be run as root" + exit $OCF_ERR_GENERIC +fi + +case "$1" in + status) if named_status + then + ocf_log info "named is up" + exit $OCF_SUCCESS + else + ocf_log info "named is down" + exit $OCF_NOT_RUNNING + fi;; + + monitor) named_monitor + exit $?;; + + start) named_start + exit $?;; + + stop) named_stop + exit $?;; + reload) named_reload + exit $?;; + *) + exit $OCF_ERR_UNIMPLEMENTED;; +esac