---
name: "ctdb_mutex_ceph_rados_helper"
section: "7"
platform: "linux"
package: "ctdb"
version: "2:4.22.11+dfsg-0+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ctdb_mutex_ceph_rados_helper"
---

# ctdb\_mutex\_ceph\_rados\_helper(7)

Ceph RADOS cluster mutex helper

## 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)](/ctdb.conf/5.md):

```
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)](/ctdb/7.md), [**ctdbd**(1)](/ctdbd/1.md), **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**.