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 <idryomov@gmail.com>
Signed-off-by: Kobi Ginon <kginon@redhat.com>

diff --git a/doc/rbd/iscsi-overview.rst b/doc/rbd/iscsi-overview.rst
index 879083c3f671b614ac66057dd33d751cb224095f..ab2d48f9e016daa675e0bd9567c9cfb4a61b3680 100644 (file)
--- 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
+   <nvmeof-overview>` for NVMe-based access.
 
 .. toctree::
   :maxdepth: 1

diff --git a/doc/rbd/iscsi-targets.rst b/doc/rbd/iscsi-targets.rst
index d2a035283bff0437ac9fb65d7450b993f4ad71f9..48edafe70c41e7c110f2a9bb710eb565ba856649 100644 (file)
--- 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
+     <https://github.com/ceph/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 <https://tracker.ceph.com/issues/75359>`__ for
+     background.
 
 -  A working Ceph Storage cluster, deployed with ``ceph-ansible`` or using the command-line interface