Ceph RADOS Mutex

## 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] [-R]

    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)
    No-register (-R): Skip registering the mutex helper as a ceph service

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/