1
0
mirror of https://github.com/minio/docs.git synced 2025-08-09 13:02:53 +03:00

draft: discourage rebalance, warn against stopping it

This commit is contained in:
Andrea Longo
2024-08-14 16:29:57 -06:00
parent 762b942009
commit a9bfde7372
3 changed files with 16 additions and 7 deletions

View File

@@ -149,12 +149,14 @@ For more information on write preference calculation logic, see :ref:`Writing Fi
Rebalancing data across all pools after an expansion is an expensive operation that requires scanning the entire deployment and moving objects between pools.
This may take a long time to complete depending on the amount of data to move.
Starting with MinIO Client version RELEASE.2022-11-07T23-47-39Z, you can manually initiate a rebalancing operation across all server pools using :mc:`mc admin rebalance`.
MinIO does not recommend manual rebalancing.
If required, you can manually initiate a rebalancing operation across all server pools using :mc:`mc admin rebalance`.
MinIO recommends `SUBNET <https://min.io/pricing?jmp=docs>`__ users `log in <https://subnet.min.io/>`__ and create a new issue to discuss appropriate rebalancing strategies for deployments.
Rebalancing does not block ongoing operations and runs in parallel to all other I/O.
This can result in reduced performance of regular operations.
Consider scheduling rebalancing operations during non-peak periods to avoid impacting production workloads.
You can start and stop rebalancing at any time
How do I upload objects to MinIO?
---------------------------------

View File

@@ -165,7 +165,10 @@ MinIO calculates the probability of a write operation to each of the pools as:
In addition to the free space calculation, if a write option (with parity) would bring a drive
usage above 99% or a known free inode count below 1000, MinIO does not write to the pool.
If desired, you can manually initiate a rebalance procedure with :mc:`mc admin rebalance`.
MinIO does not recommend manual rebalancing.
If required, you can manually initiate a rebalance procedure with :mc:`mc admin rebalance`.
MinIO recommends `SUBNET <https://min.io/pricing?jmp=docs>`__ users `log in <https://subnet.min.io/>`__ and create a new issue to discuss appropriate rebalancing strategies for deployments.
For more about how rebalancing works, see :ref:`managing objects across a deployment <minio-rebalance>`.
Likewise, MinIO does not write to pools in a decommissioning process.

View File

@@ -22,7 +22,7 @@ Description
.. start-mc-admin-rebalance-desc
The :mc-cmd:`mc admin rebalance` command allows starts, monitors, or stops a rebalancing operation on a MinIO deployment.
The :mc-cmd:`mc admin rebalance` command allows starts or monitors a rebalancing operation on a MinIO deployment.
Rebalancing redistributes objects across all pools in the deployment.
.. end-mc-admin-rebalance-desc
@@ -35,7 +35,7 @@ This is an expensive and time consuming operation.
Consider only running a rebalance procedure during light or no use of the deployment.
If write operations do occur during a rebalance operation, they process in parallel and write to a pool not actively in rebalancing.
You can stop a rebalance and start it again later as needed.
`MinIO SUBNET <https://min.io/pricing?jmp=docs>`__ users can `log in <https://subnet.min.io/>`__ and create a new issue to discuss appropriate rebalancing strategies for deployments.
Follow the progress of an ongoing rebalance operation using the following command:
@@ -67,8 +67,6 @@ The :mc-cmd:`mc admin rebalance` command has the following subcommands:
* - :mc-cmd:`mc admin rebalance status`
- Outputs the current status of an in-progress rebalance operation.
* - :mc-cmd:`mc admin rebalance stop`
- Stops an in-progress rebalance operation.
Syntax
------
@@ -135,6 +133,12 @@ Syntax
Ends an in-progress rebalance job on the specified deployment.
.. admonition:: Stop may cause data loss
:class: warning
At this time, MinIO does not recommend stopping an in-progress rebalance job.
Interrupting rebalance may result in data loss.
.. tab-set::
.. tab-item:: EXAMPLES