]> git.apps.os.sepia.ceph.com Git - ceph.git/commit
doc/rados: update config for autoscaler 55439/head
authorZac Dover <zac.dover@proton.me>
Fri, 2 Feb 2024 01:53:45 +0000 (11:53 +1000)
committerZac Dover <zac.dover@proton.me>
Sat, 3 Feb 2024 22:26:31 +0000 (08:26 +1000)
commitcc33045406ef7d868e6d9c029760f2a68271989c
treea9b7fe07ba5fb70fa87bfb4f507594648c956f5c
parent4ef2b21504153bbfc02f22d689178f5c2ecdc256
doc/rados: update config for autoscaler

Update doc/rados/configuration/pool-pg-config-ref.rst to account for the
behavior of autoscaler.

Previously, this file was last meaningfully altered in 2013, prior to
the invention of autoscaler. A recent confusion was brought to my
attention on the Ceph Slack whereby a user attempted to alter the
default values of a Quincy cluster, as suggested in this documentation.
That alteration caused Ceph to throw the error "Error ERANGE: 'pgp_num'
must be greater than 0 and lower or equal than 'pg_num', which in this
case is one" and a related "rgw_init_ioctx ERROR" reading in part
"Numerical result out of range". The user removed the
"osd_pool_default_pgp_num" configuration line from ceph.conf and the
cluster worked as expected. I presume that this is because the removal
of this configuration line allowed autoscaler to work as intended.

Fixes: https://tracker.ceph.com/issues/64259
Co-authored-by: David Orman <ormandj@corenode.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 4dc12092be584da44baca14e31ca33231164235f)
doc/rados/configuration/pool-pg-config-ref.rst