ocf_heartbeat

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"