Skip to content

Commit a4fd52f

Browse files
committed
storage: note ceph-common (rbd CLI) host dependency for encrypted RBD
Encrypted Ceph/RBD volumes require ceph-common (the rbd CLI) on every KVM host - a dependency that non-encrypted RBD does not have, since normal RBD I/O goes through libvirt+librbd. Call this out as an operational trade-off versus the qemu-native LUKS stack, which needs no extra Ceph tooling.
1 parent 8353b89 commit a4fd52f

1 file changed

Lines changed: 15 additions & 2 deletions

File tree

source/adminguide/storage.rst

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -677,8 +677,21 @@ provisioning and copy-on-write cloning:
677677
host the CloudStack agent refuses the attach with a clear error. Booting an Instance
678678
from an encrypted RBD root disk is **not** affected and works on older libvirt.
679679

680-
Requirements on the KVM host: ``ceph-common`` (the ``rbd`` CLI) and a QEMU/librbd build
681-
that supports librbd LUKS2 encryption (Ceph Pacific / QEMU 6.1 and newer).
680+
Requirements on the KVM host: a QEMU/librbd build that supports librbd LUKS2 encryption
681+
(Ceph Pacific / QEMU 6.1 and newer), and ``ceph-common`` (the ``rbd`` CLI).
682+
683+
.. important::
684+
**Encrypted RBD adds a host dependency that non-encrypted RBD does not have.** Unlike
685+
the qemu-native LUKS stack used for file-based storage and PowerFlex — which needs no
686+
extra Ceph tooling — librbd RBD encryption requires ``ceph-common`` (the ``rbd`` CLI) to
687+
be installed on **every** KVM host. A standard, non-encrypted KVM + Ceph/RBD deployment
688+
does *not* need it, because normal RBD I/O goes entirely through libvirt and librbd; the
689+
CLI is used only for the librbd LUKS2 *format* and encryption-aware *resize* steps, which
690+
are driven through the ``rbd`` command line. Without ``ceph-common`` on the host, creating,
691+
deploying, or resizing an encrypted RBD volume fails (existing non-encrypted volumes are
692+
unaffected). This is an operational trade-off to weigh against the storage efficiency
693+
librbd provides: install ``ceph-common`` from your distribution's Ceph packages, matching
694+
the librbd version already present on the host, as part of host provisioning.
682695

683696

684697
To Create a New Volume

0 commit comments

Comments
 (0)