doc/mgr: explain error message - dashboard.rst

Explain that an error message received in response to "redirect_resolve_ip_addr True" might be caused by having an insufficiently recent release of Ceph running in your cluster. Fixes: https://tracker.ceph.com/issues/61312 Signed-off-by: Zac Dover <[email protected]>
linuxbox2 · Apr 26, 2024 · 7854503 · 7854503
1 parent 4a05c14
commit 7854503
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/doc/mgr/dashboard.rst b/doc/mgr/dashboard.rst
@@ -1257,6 +1257,14 @@ You can disable it again by::
 
   $ ceph config set mgr mgr/dashboard/redirect_resolve_ip_addr False
 
+.. warning::
+
+   If you attempt to activate redirection by using the command above and you
+   get the error message ``EINVAL: unrecognized config option
+   'mgr/dashboard/redirect_resolve_ip_addr'``, then you might be running a
+   release of Ceph prior to version 17.2.6. This feature was introduced in
+   17.2.6, in this commit: https://github.com/ceph/ceph/pull/48219.
+
 HAProxy example configuration
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^