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)