From 4dee7917bf010dc6d8e24f0ef437bd8a41c355c9 Mon Sep 17 00:00:00 2001 From: Laura Flores Date: Thu, 20 Mar 2025 16:19:30 -0500 Subject: [PATCH] PendingReleaseNotes; doc/rados/operations: document "rm-pg-upmap-primary-{all}" commands Added a release note for `ceph osd rm-pg-upmap-primary` and documentation to complement #62190. Signed-off-by: Laura Flores --- PendingReleaseNotes | 5 +++++ doc/rados/operations/read-balancer.rst | 27 ++++++++++++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/PendingReleaseNotes b/PendingReleaseNotes index 904f07e774df3..31997d930c27d 100644 --- a/PendingReleaseNotes +++ b/PendingReleaseNotes @@ -107,6 +107,11 @@ metadata and data pool names to be used for creating the volume. If either is not passed or if either is a non-empty pool, the command will abort. +* RADOS: A new command, `ceph osd rm-pg-upmap-primary-all`, has been added that allows + users to clear all pg-upmap-primary mappings in the osdmap when desired. + Related trackers: + - https://tracker.ceph.com/issues/67179 + - https://tracker.ceph.com/issues/66867 >=19.2.1 diff --git a/doc/rados/operations/read-balancer.rst b/doc/rados/operations/read-balancer.rst index a2c189dbb16fa..7f74e81d1bde4 100644 --- a/doc/rados/operations/read-balancer.rst +++ b/doc/rados/operations/read-balancer.rst @@ -103,3 +103,30 @@ Primaries are updated with an offline optimizer that is built into the To see some details about what the tool is doing, you can pass ``--debug-osd 10`` to ``osdmaptool``. To see even more details, pass ``--debug-osd 20`` to ``osdmaptool``. + +Troubleshooting +=============== + +Removing pg-upmap-primary mappings +------------------------------------ + +For scenarios where you need to manually remove ``pg-upmap-primary`` mappings, Ceph provides the following +developer-level commands. These commands should be used with caution, as they directly modify +primary PG mappings and can impact read performance (this excludes any data movement). + +.. note:: + + Users affected by `#66867 `_ or `#61948 `_ + may find these commands useful when dealing with unexpected ``pg-upmap-primary`` behavior. + +To remove a specific ``pg-upmap-primary`` mapping, use: + +.. prompt:: bash $ + + ceph osd rm-pg-upmap-primary + +If you need to clear **all** ``pg-upmap-primary`` mappings in your cluster, you may use: + +.. prompt:: bash $ + + ceph osd rm-pg-upmap-primary-all -- 2.39.5