Provided by: cluster-agents_1.0.4-0ubuntu2_i386 bug

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 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
           (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 yes)

       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. 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. (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)

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 \
             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)