From: Kobi Ginon Date: Wed, 3 Jun 2026 14:03:09 +0000 (+0300) Subject: doc/rbd: clarify Rocky iSCSI gateway requirements X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=5c2881a99731bfbfea99dc29a885b251a75098e3;p=ceph.git doc/rbd: clarify Rocky iSCSI gateway requirements List Rocky Linux 8+ alongside RHEL/CentOS Stream 7.5+. Note that packaged ceph-iscsi must recognize Rocky in /etc/os-release (ceph-iscsi#282). Add a short Rocky note under iSCSI targets; expand the overview maintenance warning with migration guidance to RBD and the NVMe-oF gateway. Co-authored-by: Ilya Dryomov Signed-off-by: Kobi Ginon --- diff --git a/doc/rbd/iscsi-overview.rst b/doc/rbd/iscsi-overview.rst index 879083c3f67..ab2d48f9e01 100644 --- a/doc/rbd/iscsi-overview.rst +++ b/doc/rbd/iscsi-overview.rst @@ -46,7 +46,11 @@ Area Network (SAN). The iSCSI gateway is in maintenance as of November 2022. This means that it is no longer in active development and will not be updated to add - new features. + new features. It remains documented for existing deployments. + + New deployments should prefer accessing RBD images directly from clients + (``librbd``, QEMU, Kubernetes CSI and similar) or the :doc:`NVMe-oF gateway + ` for NVMe-based access. .. toctree:: :maxdepth: 1 diff --git a/doc/rbd/iscsi-targets.rst b/doc/rbd/iscsi-targets.rst index d2a035283bf..48edafe70c4 100644 --- a/doc/rbd/iscsi-targets.rst +++ b/doc/rbd/iscsi-targets.rst @@ -8,7 +8,15 @@ within OpenStack environments. Starting with the Ceph Luminous release, block-level access is expanding to offer standard iSCSI support allowing wider platform usage, and potentially opening new use cases. -- Red Hat Enterprise Linux/CentOS 7.5 (or newer); Linux kernel v4.16 (or newer) +- Red Hat Enterprise Linux or CentOS Stream 7.5 (or newer); Rocky Linux 8 (or newer); Linux kernel v4.16 (or newer) + + .. note:: + + **Rocky Linux:** If the Ceph container image is based on Rocky, the packaged `ceph-iscsi + `__ tooling must be new enough to treat + Rocky like other RHEL-family systems, or ``gwcli`` may fail to add gateways. + See `Orchestrator #75359 `__ for + background. - A working Ceph Storage cluster, deployed with ``ceph-ansible`` or using the command-line interface