ocf_heartbeat_CTDB(7) 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" 

AUTHOR

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