From e3460b61aac27b35ab27a6b630b58ee6f2fe0680 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Mon, 5 Feb 2024 01:36:10 +1000 Subject: [PATCH] doc/rados: update PG guidance Update the "Creating a Pool" section of doc/rados/operations/pools.rst so that the documentation no longer insists that the user change the values of "osd_pool_default_pg_num" and "osd_pool_default_pgp_num". See also: https://github.com/ceph/ceph/pull/55419 Tracker: https://tracker.ceph.com/issues/64259 Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover (cherry picked from commit 5ad241442d2c141ba508faba61f39d70f3f09679) --- doc/rados/operations/pools.rst | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) diff --git a/doc/rados/operations/pools.rst b/doc/rados/operations/pools.rst index 80005ab336da3..d6c97467a9a47 100644 --- a/doc/rados/operations/pools.rst +++ b/doc/rados/operations/pools.rst @@ -57,19 +57,12 @@ To list your cluster's pools, run the following command: Creating a Pool =============== -Before creating a pool, consult `Pool, PG and CRUSH Config Reference`_. Your -Ceph configuration file contains a setting (namely, ``pg_num``) that determines -the number of PGs. However, this setting's default value is NOT appropriate -for most systems. In most cases, you should override this default value when -creating your pool. For details on PG numbers, see `setting the number of -placement groups`_ - -For example: - -.. prompt:: bash $ - - osd_pool_default_pg_num = 128 - osd_pool_default_pgp_num = 128 +Before creating a pool, consult `Pool, PG and CRUSH Config Reference`_. The +Ceph central configuration database in the monitor cluster contains a setting +(namely, ``pg_num``) that determines the number of PGs per pool when a pool has +been created and no per-pool value has been specified. It is possible to change +this value from its default. For more on the subject of setting the number of +PGs per pool, see `setting the number of placement groups`_. .. note:: In Luminous and later releases, each pool must be associated with the application that will be using the pool. For more information, see -- 2.39.5