doc: update user docs and release notes

Fixes: https://tracker.ceph.com/issues/71495
Signed-off-by: Shraddha Agrawal <shraddhaag@ibm.com>
(cherry picked from commit ba852da68d409e29c0f3e7be68001aebc1795e08)

diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index 8b572f71cb2739ae9689ecb210b9bb6b19ba903f..5cdb68c08798155cd1b457e5c2ac945517767d8a 100644 (file)
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -147,12 +147,14 @@
   `s3:GetObjectRetention` are also considered when fetching the source object.
   Replication of tags is controlled by the `s3:GetObject(Version)Tagging` permission.
 
-* RADOS: A new command, `ceph osd pool availability-status`, has been added that allows
+* RADOS: A new command, ``ceph osd pool availability-status``, has been added that allows
   users to view the availability score for each pool in a cluster. A pool is considered 
   unavailable if any PG in the pool is not in active state or if there are unfound 
   objects. Otherwise the pool is considered available. The score is updated every 
-  5 seconds. The feature is on by default. A new config option `enable_availability_tracking`
-  can be used to turn off the feature if required. This feature is in tech preview. 
+  5 seconds. The feature is on by default. A new config option ``enable_availability_tracking``
+  can be used to turn off the feature if required. Another command is added to clear the 
+  availability status for a specific pool, ``ceph osd pool clear-availability-status <pool-name>``. 
+  This feature is in tech preview. 
   Related trackers:
    - https://tracker.ceph.com/issues/67777
 

diff --git a/doc/rados/operations/monitoring.rst b/doc/rados/operations/monitoring.rst
index 5670b659612ad42170792d3e209ada1333156e1a..90d5fc90a7df2a25c2e1ce6f4f41248f22353522 100644 (file)
--- a/doc/rados/operations/monitoring.rst
+++ b/doc/rados/operations/monitoring.rst
@@ -794,4 +794,13 @@ downtime, the ``enable_availability_tracking`` config option can be set to ``fal
    ceph config set mon enable_availability_tracking false
 
 While the feature is turned off, the last calculated score will be preserved. The 
-score will again start updating once the feature is turned on again. 
\ No newline at end of file
+score will again start updating once the feature is turned on again. 
+
+It's also possible to clear the data availability score for a specific 
+pool if needed with a command of the following form:
+
+.. prompt:: bash $
+
+   ceph osd pool clear-availability-status <pool-name>
+
+Note: Clearing a score is not allowed if the feature itself is disabled. 
\ No newline at end of file