CEPH-MDS(8)

📦
version 20.2.4 · 20 versions
, in ubuntu stonking

💖 NAME 💖

okay so bestie, welcome to the ceph-mds(8) page of the Ceph manual — this is the one about ceph-mds, the ceph metadata server daemon. 🦋

✨ SYNOPSIS ✨

ceph-mds -i <ID> [flags]

🌸 DESCRIPTION 🌸

ceph-mds is the metadata server daemon for the Ceph distributed file system. One or more instances of ceph-mds collectively manage the file system namespace, coordinating access to the shared OSD cluster. it's giving teamwork, it's giving delegation, it's giving main character energy but make it a cluster. 👑

Each ceph-mds daemon instance should have a unique name. That name is used to identify daemon instances in the ceph.conf. no two besties with the same name, that's the rule. 💅

Once the daemon has started, the monitor cluster will normally assign it a logical rank, or put it in a standby pool to take over for another daemon that crashes. So like, it might be the responsible one holding the rank, or it might be chilling on the bench waiting to sub in when someone faceplants. 😭 Some of the specified options can cause other behaviors — so yes, the flags below can change up the whole vibe.

🎀 OPTIONS 🎀

  • -f, --foreground — Foreground mode, bestie: don't daemonize after startup (aka run in the foreground). Also does not generate a pid file. Super useful when you're running it via ceph-run <>(8). 🫶
  • -d — Debug mode: it's like -f, but it also sends all log output to stderr. everything. all of it. on your screen. right now. 💀
  • --setuser userorgid — Set the uid after starting. If you pass a username, the user record gets looked up to get a uid and a gid, and that gid is set too — unless --setgroup is also specified. so don't double up, she's picky. ✨
  • --setgroup grouporgid — Set the gid after starting. If you pass a group name, the group record gets looked up to get a gid. 🍓
  • -c ceph.conf, --conf=ceph.conf — Use the ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to determine monitor addresses during startup. yes this is how you tell it where to look. 📂
  • -m monaddress[:port] — Connect to the specified monitor (instead of looking through ceph.conf). straight to the source, no middleman. 🎯
  • --id/-i ID — Set the ID portion of the MDS name. Heads up though: the ID should not start with a numeric digit. 🚫
  • --name/-n TYPE.ID — Set the MDS name in the format TYPE.ID. The TYPE is obviously 'mds'. And same rule as above: the ID should not start with a numeric digit. 💜

🌈 AVAILABILITY 🌈

ceph-mds is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at <https://docs.ceph.com> for more information. iykyk, go read the docs, they're iconic. 📚

👯 SEE ALSO 👯

ceph <>(8), ceph-mon <>(8), ceph-osd <>(8)

the whole squad, fr fr. 🔥

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0). slay, legally speaking. ⭐

okay bestie that's the whole page!! 🎀 this one came from the dev version of the Ceph manual, dated Oct 06, 2026, and it's filed under CEPH-MDS(8). go forth and run your metadata servers, you absolute queen. 💖✨🦋

📦 where this page comes from