From: Alfredo Deza Date: Fri, 22 Sep 2017 12:50:01 +0000 (-0400) Subject: docs/rados warn against possible data loss if min_size cannot be met X-Git-Tag: v13.0.1~715^2~2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=88f5b93219d04cccd2c1011c9007bc47b94f9e30;p=ceph.git docs/rados warn against possible data loss if min_size cannot be met Signed-off-by: Alfredo Deza --- diff --git a/doc/rados/configuration/pool-pg-config-ref.rst b/doc/rados/configuration/pool-pg-config-ref.rst index dd416edfa38..1566d7e6365 100644 --- a/doc/rados/configuration/pool-pg-config-ref.rst +++ b/doc/rados/configuration/pool-pg-config-ref.rst @@ -10,7 +10,7 @@ recommend** overridding some of the defaults. Specifically, we recommend setting a pool's replica size and overriding the default number of placement groups. You can specifically set these values when running `pool`_ commands. You can also override the defaults by adding new ones in the ``[global]`` section of your -Ceph configuration file. +Ceph configuration file. .. literalinclude:: pool-pg.conf @@ -25,18 +25,18 @@ Ceph configuration file. :Default: ``65536`` -``mon pg create interval`` +``mon pg create interval`` -:Description: Number of seconds between PG creation in the same +:Description: Number of seconds between PG creation in the same Ceph OSD Daemon. :Type: Float :Default: ``30.0`` -``mon pg stuck threshold`` +``mon pg stuck threshold`` -:Description: Number of seconds after which PGs can be considered as +:Description: Number of seconds after which PGs can be considered as being stuck. :Type: 32-bit Integer @@ -127,7 +127,7 @@ Ceph configuration file. :Description: Placement group bits per Ceph OSD Daemon. :Type: 32-bit Integer -:Default: ``6`` +:Default: ``6`` ``osd pgp bits`` @@ -139,7 +139,7 @@ Ceph configuration file. ``osd crush chooseleaf type`` -:Description: The bucket type to use for ``chooseleaf`` in a CRUSH rule. Uses +:Description: The bucket type to use for ``chooseleaf`` in a CRUSH rule. Uses ordinal rank rather than name. :Type: 32-bit Integer @@ -156,7 +156,7 @@ Ceph configuration file. See `Weighting Bucket Items`_ for details. -``osd pool default crush replicated ruleset`` +``osd pool default crush replicated ruleset`` :Description: The default CRUSH ruleset to use when creating a replicated pool. :Type: 8-bit Integer @@ -191,30 +191,30 @@ Ceph configuration file. ``osd pool default min size`` -:Description: Sets the minimum number of written replicas for objects in the - pool in order to acknowledge a write operation to the client. - If minimum is not met, Ceph will not acknowledge the write to the - client. This setting ensures a minimum number of replicas when - operating in ``degraded`` mode. +:Description: Sets the minimum number of written replicas for objects in the + pool in order to acknowledge a write operation to the client. If + minimum is not met, Ceph will not acknowledge the write to the + client, **which may result in data loss**. This setting ensures + a minimum number of replicas when operating in ``degraded`` mode. :Type: 32-bit Integer -:Default: ``0``, which means no particular minimum. If ``0``, +:Default: ``0``, which means no particular minimum. If ``0``, minimum is ``size - (size / 2)``. -``osd pool default pg num`` +``osd pool default pg num`` -:Description: The default number of placement groups for a pool. The default +:Description: The default number of placement groups for a pool. The default value is the same as ``pg_num`` with ``mkpool``. :Type: 32-bit Integer -:Default: ``8`` +:Default: ``8`` -``osd pool default pgp num`` +``osd pool default pgp num`` -:Description: The default number of placement groups for placement for a pool. - The default value is the same as ``pgp_num`` with ``mkpool``. +:Description: The default number of placement groups for placement for a pool. + The default value is the same as ``pgp_num`` with ``mkpool``. PG and PGP should be equal (for now). :Type: 32-bit Integer @@ -223,14 +223,14 @@ Ceph configuration file. ``osd pool default flags`` -:Description: The default flags for new pools. +:Description: The default flags for new pools. :Type: 32-bit Integer :Default: ``0`` ``osd max pgls`` -:Description: The maximum number of placement groups to list. A client +:Description: The maximum number of placement groups to list. A client requesting a large number can tie up the Ceph OSD Daemon. :Type: Unsigned 64-bit Integer @@ -238,9 +238,9 @@ Ceph configuration file. :Note: Default should be fine. -``osd min pg log entries`` +``osd min pg log entries`` -:Description: The minimum number of placement group logs to maintain +:Description: The minimum number of placement group logs to maintain when trimming log files. :Type: 32-bit Int Unsigned