minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-07-31 18:04:52 +03:00
Code Activity

MinIO Erasure Stripe Size (#1183)

Browse Source 
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 <klauspost@gmail.com>
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
This commit is contained in:
Ravind Kumar
2024-04-10 17:46:08 -04:00
committed by GitHub
parent f9614765a8
commit c06a77403e
1 changed files with 37 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
source/reference/minio-server/settings/core.rst
View File

@ -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 <minio-data-compression-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 <minio-ec-basics>` 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.