NAME

       ctdb_mutex_ceph_rados_helper - Ceph RADOS cluster mutex helper

DESCRIPTION

       ctdb_mutex_ceph_rados_helper can be used as a cluster lock provider for CTDB. When
       configured, split brain avoidance during CTDB recovery will be handled using locks against
       an object located in a Ceph RADOS pool. To enable this functionality, include the
       following line in the [cluster] section of ctdb.conf(5):

           cluster lock = !ctdb_mutex_ceph_rados_helper [Cluster] [User] [Pool] [Object] [Timeout] [-n Namespace]

           Cluster: Ceph cluster name (e.g. ceph)
           User: Ceph cluster user name (e.g. client.admin)
           Pool: Ceph RADOS pool name
           Object: Ceph RADOS object name
           Timeout: Ceph RADOS lock duration in seconds (optional)
           Namespace: Ceph RADOS pool namespace (optional)

       The Ceph cluster Cluster must be up and running, with a configuration, and keyring file
       for User located in a librados default search path (e.g. /etc/ceph/).  Pool must already
       exist.

       For informational purposes, ctdb_mutex_ceph_rados_helper will also register the cluster
       lock holder in Ceph Manager's service map.

SEE ALSO

       ctdb(7), ctdbd(1), http://ctdb.samba.org/

AUTHOR

       This documentation was written by David Disseldorp

COPYRIGHT

       Copyright © 2016 David Disseldorp

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as published by the Free Software Foundation; either
       version 3 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if not, see http://www.gnu.org/licenses.