OCF_HEARTBEAT_CTDB(7) OCF resource agents OCF_HEARTBEAT_CTDB(7)NAMEocf_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 the CTDB lock will be stored. Create /etc/ctdb/nodes
containing a list of private IP addresses of each node in the cluster,
then configure this RA as a clone. To have CTDB manage Samba, set
ctdb_manages_samba="yes". Note that this option will be deprecated in
future, in favour of configuring a separate Samba resource.
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
(unique, required, string, no default)
ctdb_manages_samba
Should CTDB manage starting/stopping the Samba service for you?
This will be deprecated in future, in favor of configuring a
separate Samba resource.
(optional, boolean, default no)
ctdb_manages_winbind
Should CTDB manage starting/stopping the Winbind service for you?
This will be deprecated in future, in favor of configuring a
separate Winbind resource.
(optional, boolean, default no)
ctdb_service_smb
Name of smb init script. Only necessary if CTDB is managing Samba
directly. Will usually be auto-detected.
(optional, string, no default)
ctdb_service_nmb
Name of nmb init script. Only necessary if CTDB is managing Samba
directly. Will usually be auto-detected.
(optional, string, no default)
ctdb_service_winbind
Name of winbind init script. Only necessary if CTDB is managing
Winbind directly. Will usually be auto-detected.
(optional, string, no default)
ctdb_samba_skip_share_check
If there are very many shares it may not be feasible to check that
all of them are available during each monitoring interval. In that
case this check can be disabled.
(optional, boolean, default yes)
ctdb_monitor_free_memory
If the amount of free memory drops below this value the node will
become unhealthy and ctdb and all managed services will be
shutdown. Once this occurs, the administrator needs to find the
reason for the OOM situation, rectify it and restart ctdb with
"service ctdb start".
(optional, integer, default 100)
ctdb_start_as_disabled
When set to yes, the CTDB node will start in DISABLED mode and not
host any public ip addresses.
(optional, boolean, default no)
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.
(unique, 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.
(unique, 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. Only necessary if CTDB is
managing Samba.
(optional, string, default "/etc/samba/smb.conf")
smb_private_dir
The directory for smbd to use for storing such files as smbpasswd
and secrets.tdb. Old versions of CTBD (prior to 1.0.50) required
this to be on shared storage. This parameter should not be set for
current versions of CTDB, and only remains in the RA for backwards
compatibility.
(unique, optional, string, no default)
smb_passdb_backend
Which backend to use for storing user and possibly group
information. Only necessary if CTDB is managing Samba.
(optional, string, default "tdbsam")
smb_idmap_backend
Which backend to use for SID/uid/gid mapping. Only necessary if
CTDB is managing Samba.
(optional, string, default "tdb2")
smb_fileid_algorithm
Which fileid:algorithm to use with vfs_fileid. The correct value
depends on which clustered filesystem is in use, e.g.: for OCFS2,
this should be set to "fsid". Only necessary if CTDB is managing
Samba.
(optional, string, no default)
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 p_CTDB ocf:heartbeat:CTDB \
params \
ctdb_recovery_lock=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 UNKNOWN 03/24/2013 OCF_HEARTBEAT_CTDB(7)
