CTDB_MUTEX_CEPH_RADOS_HELPER(7)

📦
version 4.24.7 · 19 versions
, in ubuntu stonking

✨ CEPH RADOS MUTEX(7) ✨

okay bestie, so this is a page from the CTDB — clustered TDB database manual, and it's all about a lil helper called ctdb_mutex_ceph_rados_helper. it's giving "the friend who holds the group's stuff so nobody double-books it" energy, and honestly? iconic. 💅

🌸 NAME 🌸

ctdb_mutex_ceph_rados_helper — the Ceph RADOS cluster mutex helper 🧚

💖 DESCRIPTION 💖

so like, ctdb_mutex_ceph_rados_helper can be used as a cluster lock provider for CTDB. when you configure it, split brain avoidance during CTDB recovery gets handled using locks against an object that lives in a Ceph RADOS pool. yes, that's the whole vibe.

to turn this functionality on, you literally just drop this line into the [cluster] section of ctdb.conf(5):

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

and here's what all those lil placeholders mean, no gatekeeping:

  • 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

now, the fine print, and bestie you need this part:

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

also, purely for informational purposes, ctdb_mutex_ceph_rados_helper will also register the cluster lock holder in Ceph Manager's service map. cute, right?

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

this documentation was written by David Disseldorp

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.

and that's the whole page, bestie!! this beauty came out of the ctdb manual, dated 09/13/2026, and it's filed under CEPH RADOS MUTEX(7). periodt. 💖✨🎀

📦 where this page comes from