Skip to content

Commit d581a27

Browse files
committed
Merge PR ceph#64153 into main
* refs/pull/64153/head: Revert "Merge pull request ceph#64111 from zdover23/wip-doc-2025-06-23-tr71796-rados-ops-balancer" Reviewed-by: Zac Dover <[email protected]> Reviewed-by: Greg Farnum <[email protected]>
2 parents 0e4eb99 + bee8637 commit d581a27

File tree

2 files changed

+6
-13
lines changed

2 files changed

+6
-13
lines changed

doc/rados/operations/balancer.rst

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -60,14 +60,12 @@ of the following form:
6060
A larger value may increase the speed of cluster balancing / convergence
6161
at the potential cost of greater impact on client operations.
6262

63-
The setting ``upmax_max_deviation`` sets the threshold at which the balancer
64-
module considers the cluster's distribution of PGs adequately balanced. At the
65-
time of writing (June 2025), this value defaults to ``5``, which means that a
66-
given OSD's PG replicas are considered adequately balanced when they vary by
67-
five or fewer above or below the cluster's average. Here are the details of
68-
this configurable:
69-
70-
.. confval:: upmap_max_deviation
63+
There is a separate setting ``upmap_max_deviation`` for how uniform the
64+
distribution of PGs must be for the module to consider the cluster adequately
65+
balanced. At the time of writing (June 2025), this value defaults to ``5``,
66+
which means that if a given OSD's PG replicas vary by five or fewer above or
67+
below the cluster's average, it will be considered sufficiently balanced.
68+
7169

7270
This value of PG replicas / shards (as distinct from logical PGs) is reported
7371
by the ``ceph osd df`` command under the ``PGS`` column and the variance

src/common/options/global.yaml.in

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6834,8 +6834,3 @@ options:
68346834
level: dev
68356835
default: 0
68366836
desc: When EC writes should generate PDWs (development only) 0=optimal 1=never 2=when possible
6837-
- name: upmap_max_deviation
6838-
type: int
6839-
level: unknown (fixme)
6840-
default: 5
6841-
desc: If the number of PGs is within this count then no optimization is attempted

0 commit comments

Comments
 (0)