From: Sage Weil <sage@redhat.com>
Date: Mon, 25 Feb 2019 16:07:14 +0000 (-0600)
Subject: doc/releases/nautilus: add msgr2 enablement steps
X-Git-Tag: v14.1.1~115^2~3
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=a196da4f8b7f851a736080edf5b30f4c133b8b0d;p=ceph-ci.git

doc/releases/nautilus: add msgr2 enablement steps

Signed-off-by: Sage Weil <sage@redhat.com>
---

diff --git a/doc/releases/nautilus.rst b/doc/releases/nautilus.rst
index 5baf98743b1..a1c04f782db 100644
--- a/doc/releases/nautilus.rst
+++ b/doc/releases/nautilus.rst
@@ -233,6 +233,43 @@ Instructions
 
 #. Verify the cluster is healthy with ``ceph health``.
 
+#. To enable the new v2 network protocol, issue the following command::
+
+     ceph mon enable-msgr2
+
+   This will instruct all monitors that bind to the old default port
+   6789 for the legacy v1 protocol to also bind to the new 3300 v2
+   protocol port.  To see if all monitors have been updated,::
+
+     ceph mon dump
+
+   and verify that each monitor has both a ``v2:`` and ``v1:`` address
+   listed.
+
+#. For each host that has been upgrade, you should update your
+   ``ceph.conf`` file so that it references both the v2 and v1
+   addresses.  Things will still work if only the v1 IP and port are
+   listed, but each CLI instantiation or daemon will need to reconnect
+   after learning the monitors real IPs, slowing things down a bit and
+   preventing a full transition to the v2 protocol.
+
+   This is also a good time to fully transition any config options in
+   ceph.conf into the cluster's configuration database.  On each host,
+   you can use the following command to import any option into the
+   monitors with::
+
+     ceph config assimilate-conf -i /etc/ceph/ceph.conf
+
+   To create a minimal but sufficient ceph.conf for each host,::
+
+     ceph config generate-minimal-conf > /etc/ceph/ceph.conf
+
+   Be sure to use this new config--and, specifically, the new syntax
+   for the ``mon_host`` option that lists both ``v2:`` and ``v1:``
+   addresses in brackets--on hosts that have been upgraded to
+   Nautilus, since pre-nautilus versions of Ceph to not understand the
+   syntax.
+
 
 Upgrading from pre-Luminous releases (like Jewel)
 -------------------------------------------------