RBD-MIRROR(8)

📦
version 20.2.4 · 20 versions
, in ubuntu stonking

💖 NAME 💖

rbd-mirror — the Ceph daemon that mirrors your RBD images, no cap ✨

🦋 SYNOPSIS 🦋

rbd-mirror

🌸 DESCRIPTION 🌸

okay so bestie, picture this: rbd-mirror is a daemon that does asynchronous mirroring of RADOS block device (rbd) images between Ceph clusters. What it actually does is replay the changes from images over in the remote clusters onto images in a local cluster, and the whole point of that is disaster recovery. like, if everything goes sideways, you still have your stuff. iconic behavior tbh 💅

It reaches out to those remote clusters over the RADOS protocol, and it relies on the default search paths to find the ceph.conf files, the monitor addresses, and the authentication info for them. Those paths are:

  • /etc/ceph/$cluster.conf
  • /etc/ceph/$cluster.keyring
  • /etc/ceph/$cluster.$name.keyring

and here's the lore on those variables 🫶: $cluster is the human-friendly name of the cluster, and $name is the rados user you're connecting as — for example, client.rbd-mirror.

✨ OPTIONS ✨

  • -c ceph.conf, --conf=ceph.conf — use this ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to figure out the monitor addresses when it starts up 🔍
  • -m monaddress[:port] — connect to the monitor you name here directly, instead of digging through ceph.conf for it
  • -i ID, --id ID — set the ID part of the name for rbd-mirror
  • -n TYPE.ID, --name TYPE.ID — set the rados user name for the gateway, like client.rbd-mirror for example
  • --cluster NAME — set the cluster name (default: ceph)
  • -d — run in the foreground, and log to stderr 📝
  • -f — run in the foreground, and log to the usual location 📂

🌈 AVAILABILITY 🌈

rbd-mirror is part of Ceph — a massively scalable, open-source, distributed storage system. For more info, go read the Ceph documentation at https://docs.ceph.com 👑

🎀 SEE ALSO 🎀

rbd(8)

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

and that's the whole page bestie 🫶 this lil writeup is from dev, dated Oct 06, 2026, and it's the RBD-MIRROR(8) page. slay, go mirror some images 💅✨

📦 where this page comes from