From b4e06c5b315f3eb468cb0d97067f5a70e7a1aaac Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Thu, 6 Feb 2020 07:09:29 -0600 Subject: [PATCH] doc/rados/operations: adjust docs a bit Signed-off-by: Sage Weil --- doc/man/8/ceph.rst | 2 +- doc/rados/operations/pools.rst | 18 +++++++++--------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/man/8/ceph.rst b/doc/man/8/ceph.rst index 7e125b96b91..7c98629637f 100644 --- a/doc/man/8/ceph.rst +++ b/doc/man/8/ceph.rst @@ -1036,7 +1036,7 @@ Subcommand ``create`` creates pool. Usage:: ceph osd pool create {} {} {replicated|erasure} - {} {} {} + {} {} {} {--autoscale-mode=} Subcommand ``delete`` deletes pool. diff --git a/doc/rados/operations/pools.rst b/doc/rados/operations/pools.rst index 8aa6f378b69..70dca8c75dc 100644 --- a/doc/rados/operations/pools.rst +++ b/doc/rados/operations/pools.rst @@ -61,7 +61,7 @@ To create a pool, execute:: ceph osd pool create {pool-name} [{pg-num} [{pgp-num}]] [replicated] \ [crush-rule-name] [expected-num-objects] ceph osd pool create {pool-name} [{pg-num} [{pgp-num}]] erasure \ - [erasure-code-profile] [crush-rule-name] [expected_num_objects] + [erasure-code-profile] [crush-rule-name] [expected_num_objects] [--autoscale-mode=] Where: @@ -131,15 +131,15 @@ Where: :Type: String :Required: No. -When you create a pool, set the number of placement groups to a reasonable value -(e.g., ``100``). Consider the total number of placement groups per OSD too. -Placement groups are computationally expensive, so performance will degrade when -you have many pools with many placement groups (e.g., 50 pools with 100 -placement groups each). The point of diminishing returns depends upon the power -of the OSD host. +``--autoscale-mode=`` -See `Placement Groups`_ for details on calculating an appropriate number of -placement groups for your pool. +:Description: Autoscale mode + +:Type: String +:Required: No. +:Default: The default behavior is controlled by the ``osd pool default pg autoscale mode`` option. + +If you set the autoscale mode to ``on`` or ``warn``, you can let the system autotune or recommend changes to the number of placement groups in your pool based on actual usage. If you leave it off, then you should refer to `Placement Groups`_ for more information. .. _Placement Groups: ../placement-groups -- 2.39.5