From c06a77403e9064ffd71093a5c18abe129df0036a Mon Sep 17 00:00:00 2001 From: Ravind Kumar Date: Wed, 10 Apr 2024 17:46:08 -0400 Subject: [PATCH] MinIO Erasure Stripe Size (#1183) Staged: http://192.241.195.202:9000/staging/ERASURE_STRIPE_SIZE/linux/reference/minio-server/settings/core.html#erasure-stripe-size # Overview We get somewhat frequent inquiries on how to set a stripe size. We're going to document the option, but heavily emphasize how carefully this needs to be handled The defaults are *almost always* the best choice. We are not going to provide any additional guidance here. --------- Co-authored-by: Klaus Post Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com> --- .../reference/minio-server/settings/core.rst | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/source/reference/minio-server/settings/core.rst b/source/reference/minio-server/settings/core.rst index a45e98d7..3874645b 100644 --- a/source/reference/minio-server/settings/core.rst +++ b/source/reference/minio-server/settings/core.rst @@ -295,3 +295,40 @@ Defaults to ``"text/*, application/json, application/xml, binary/octet-stream"`` Some types of files cannot be significantly reduced in size. MinIO will *not* compress these, even if specified in an :mc-conf:`~compression.mime_types` argument. See :ref:`Excluded types ` for details. + +Erasure Stripe Size +~~~~~~~~~~~~~~~~~~~ + +.. tab-set:: + + .. tab-item:: Environment Variable + :sync: envvar + + .. envvar:: MINIO_ERASURE_SET_DRIVE_COUNT + + .. tab-item:: Configuration Variable + :sync: config + + .. include:: /includes/common-mc-admin-config.rst + :start-after: start-minio-settings-no-config-option + :end-before: end-minio-settings-no-config-option + +*Optional* + +The :ref:`erasure set size ` to apply for all drives in a given :term:`server pool`. + +If you set this value, you **must** do so *before* you initialize the cluster +The selected stripe size is **immutable** after the cluster has been initialized and affects any future server pools added to the cluster. + +|subnet| users should log in and open an issue to discuss stripe size settings prior to implementing them in any environment. + +.. important:: + + **Do not** change the stripe size setting unless directed to by MinIO engineering. + + Changes to stripe size have significant impact to deployment functionality, availability, performance, and behavior. + MinIO's stripe selection algorithms set appropriate defaults for the majority of workloads. + Changing the stripe size from this default is unusual and generally not necessary or advised. + + + \ No newline at end of file