From 98ae20c2c874fda2251046aed397833e41449d1e Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Fri, 10 Jan 2020 11:54:51 +1000 Subject: [PATCH] doc: emphasize the importance of require-osd-release nautilus This commit adds a red warning (in an "important" admonition) directing the reader to make certain to run "ceph osd require-osd-release nautilus" before enabling the v2 network protocol. This change applies only to the procedure that explains how to upgrade to Nautilus from Mimic or Luminous. Signed-off-by: Zac Dover --- doc/releases/nautilus.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/releases/nautilus.rst b/doc/releases/nautilus.rst index f53350068e2..134897b1dfd 100644 --- a/doc/releases/nautilus.rst +++ b/doc/releases/nautilus.rst @@ -1333,6 +1333,8 @@ Instructions # ceph osd require-osd-release nautilus + .. important:: This step is mandatory. Failure to execute this step will make it impossible for OSDs to communicate after msgrv2 is enabled. + #. If you set ``noout`` at the beginning, be sure to clear it with:: # ceph osd unset noout @@ -1375,6 +1377,13 @@ Instructions and verify that each monitor has both a ``v2:`` and ``v1:`` address listed. + .. important:: + Before this step is run, the following command must already have been run: + + # ceph osd require-osd-release nautilus + + If this command (step 10 in this procedure) has not been run, OSDs will lose the ability to communicate. + #. For each host that has been upgraded, you should update your ``ceph.conf`` file so that it either specifies no monitor port (if you are running the monitors on the default ports) or references -- 2.39.5