doc/rados/operations: document `ceph balancer status detail`

Document change in https://github.com/ceph/ceph/pull/54801

Signed-off-by: Laura Flores <lflores@ibm.com>
(cherry picked from commit 159751b68085fbe0fe10a881ff8bedecda11142f)

diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index 0f10fccbbcf7e0b3c6346b7c6c2f06f99db6dfef..7526f34f194a366fa0993470e7f65496b52da821 100644 (file)
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -57,6 +57,21 @@
   cannot repair the dates of existing object locks. Such objects can be identified
   with a HeadObject request based on the x-amz-object-lock-retain-until-date
   response header.
+* RADOS: `get_pool_is_selfmanaged_snaps_mode` C++ API has been deprecated
+  due to being prone to false negative results.  It's safer replacement is
+  `pool_is_in_selfmanaged_snaps_mode`.
+* RADOS: For bug 62338 (https://tracker.ceph.com/issues/62338), we did not choose
+  to condition the fix on a server flag in order to simplify backporting.  As
+  a result, in rare cases it may be possible for a PG to flip between two acting
+  sets while an upgrade to a version with the fix is in progress.  If you observe
+  this behavior, you should be able to work around it by completing the upgrade or
+  by disabling async recovery by setting osd_async_recovery_min_cost to a very
+  large value on all OSDs until the upgrade is complete:
+  ``ceph config set osd osd_async_recovery_min_cost 1099511627776``
+* RADOS: A detailed version of the `balancer status` CLI command in the balancer
+  module is now available. Users may run `ceph balancer status detail` to see more
+  details about which PGs were updated in the balancer's last optimization.
+  See https://docs.ceph.com/en/latest/rados/operations/balancer/ for more information.
 
 >=18.0.0
 

diff --git a/doc/rados/operations/balancer.rst b/doc/rados/operations/balancer.rst
index aa4eab93cf96e56f49d9e98af91d4ffd2a7edcc7..5f87865bcf32b9c2fa2192506e8f2a8b4f3647de 100644 (file)
--- a/doc/rados/operations/balancer.rst
+++ b/doc/rados/operations/balancer.rst
@@ -205,6 +205,12 @@ command:
 
       ceph balancer status
 
+To see the status in greater detail, run the following command:
+
+   .. prompt:: bash $
+
+      ceph balancer status detail
+
 To evaluate the distribution that would result from executing a specific plan,
 run the following command: