From: Shraddha Agrawal Date: Thu, 19 Jun 2025 13:05:06 +0000 (+0530) Subject: doc: update user docs and release notes X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=4ab83844373c0d60928ddb1671d0f4d20b88b3aa;p=ceph.git doc: update user docs and release notes Fixes: https://tracker.ceph.com/issues/71495 Signed-off-by: Shraddha Agrawal (cherry picked from commit ba852da68d409e29c0f3e7be68001aebc1795e08) --- diff --git a/PendingReleaseNotes b/PendingReleaseNotes index 8b572f71cb273..5cdb68c087981 100644 --- 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 ``. + 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 5670b659612ad..90d5fc90a7df2 100644 --- 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 + +Note: Clearing a score is not allowed if the feature itself is disabled. \ No newline at end of file