OCF_HEARTBEAT_CTDB(7)						OCF resource agents					     OCF_HEARTBEAT_CTDB(7)

NAME

       ocf_heartbeat_CTDB - CTDB Resource Agent

SYNOPSIS

       CTDB [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

       This resource agent manages CTDB, allowing one to use Clustered Samba in a Linux-HA/Pacemaker cluster. You need a shared filesystem (e.g.
       OCFS2) on which CTDB lock and Samba state will be stored. Configure shares in smb.conf on all nodes, and create /etc/ctdb/nodes containing
       a list of private IP addresses of each node in the cluster. Configure this RA as a clone, and it will take care of the rest. For more
       information see http://linux-ha.org/wiki/CTDB_(resource_agent)

SUPPORTED PARAMETERS

       ctdb_recovery_lock
	   The location of a shared lock file, common across all nodes. This must be on shared storage, e.g.: /shared-fs/samba/ctdb.lock
	   (required, string, no default)

       smb_private_dir
	   The directory for smbd to use for storing such files as smbpasswd and secrets.tdb. This must be on shared storage, e.g.:
	   /shared-fs/samba/private (required, string, no default)

       ctdb_config_dir
	   The directory containing various CTDB configuration files. The "nodes" and "notify.sh" scripts are expected to be in this directory, as
	   is the "events.d" subdirectory. (optional, string, default /etc/ctdb)

       ctdb_binary
	   Full path to the CTDB binary. (optional, string, default /usr/bin/ctdb)

       ctdbd_binary
	   Full path to the CTDB cluster daemon binary. (optional, string, default /usr/sbin/ctdbd)

       ctdb_socket
	   Full path to the domain socket that ctdbd will create, used for local clients to attach and communicate with the ctdb daemon.
	   (optional, string, default /var/lib/ctdb/ctdb.socket)

       ctdb_dbdir
	   The directory to put the local CTDB database files in. Persistent database files will be put in ctdb_dbdir/persistent. (optional,
	   string, default /var/lib/ctdb)

       ctdb_logfile
	   Full path to log file. To log to syslog instead, use the value "syslog". (optional, string, default /var/log/ctdb/log.ctdb)

       ctdb_debuglevel
	   What debug level to run at (0-10). Higher means more verbose. (optional, integer, default 2)

       smb_conf
	   Path to default samba config file. (optional, string, default /etc/samba/smb.conf)

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
	   Starts the resource. Suggested minimum timeout: 90.

       stop
	   Stops the resource. Suggested minimum timeout: 100.

       monitor
	   Performs a detailed status check. Suggested minimum timeout: 20. Suggested interval: 10.

       meta-data
	   Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5.

       validate-all
	   Performs a validation of the resource configuration. Suggested minimum timeout: 30.

EXAMPLE

       The following is an example configuration for a CTDB resource using the crm(8) shell:

	   primitive example_CTDB ocf:heartbeat:CTDB 
	     params 
	       ctdb_recovery_lock=string 
	       smb_private_dir=string 
	     op monitor timeout="20" interval="10" depth="0"

SEE ALSO

       http://www.linux-ha.org/wiki/CTDB_(resource_agent)

AUTHOR

       Linux-HA contributors (see the resource agent source for information about individual authors)

resource-agents 1.0.3						    07/05/2010						     OCF_HEARTBEAT_CTDB(7)