update source to Ceph Pacific 16.2.2

[ceph.git] / ceph / doc / rados / operations / upmap.rst

diff --git a/ceph/doc/rados/operations/upmap.rst b/ceph/doc/rados/operations/upmap.rst
index 8bad0d9592859260454bd008d1be48eb8e8fb34f..6e7ce5f639457f29982008b58df3516bca8b8bfa 100644 (file)
--- a/ceph/doc/rados/operations/upmap.rst
+++ b/ceph/doc/rados/operations/upmap.rst
@@ -1,3 +1,5 @@
+.. _upmap:
+
 Using the pg-upmap
 ==================
 
@@ -12,8 +14,13 @@ clients understand the new *pg-upmap* structure in the OSDMap.
 Enabling
 --------
 
-To allow use of the feature, you must tell the cluster that it only
-needs to support luminous (and newer) clients with::
+New clusters will have this module on by default. The cluster must only
+have luminous (and newer) clients. You can the turn the balancer off with::
+
+  ceph balancer off
+
+To allow use of the feature on existing clusters, you must tell the
+cluster that it only needs to support luminous (and newer) clients with::
 
   ceph osd set-require-min-compat-client luminous
 
@@ -26,8 +33,8 @@ use with::
 Balancer module
 -----------------
 
-The new `balancer` module for ceph-mgr will automatically balance
-the number of PGs per OSD.  See ``Balancer``
+The `balancer` module for ceph-mgr will automatically balance
+the number of PGs per OSD.  See :ref:`balancer`
 
 
 Offline optimization