mc admin heal
Description
The mc admin heal
command scans for objects that are damaged or corrupted and heals those objects.
mc admin heal
is resource intensive and typically not required as a manual process, even after drive failures or corruption events.
As a part of normal operations, MinIO:
automatically heals objects damaged by silent bit rot corruption, drive failure, or other issues on each
POST
orGET
operation.performs periodic background object healing using the scanner.
aggressively heals objects after drive replacement.
Refer to Object Healing for more details on how MinIO heals objects.
Use mc admin
on MinIO Deployments Only
MinIO does not support using mc admin
commands with other
S3-compatible services, regardless of their claimed compatibility with MinIO
deployments.
Syntax
mc admin heal
has the following syntax:
mc admin heal [FLAGS] TARGET \
[--all-drives, -a] \
[--force] \
[--verbose, -v]
mc admin heal
supports the following arguments:
- TARGET
- Required
The full path to the bucket or bucket prefix on which the command should perform object healing. Specify the
alias
of a configured MinIO deployment as the prefix for the path. For example:mc admin heal play/mybucket/myprefix
If the
TARGET
bucket or bucket prefix has an active healing scan, the command returns the status of that scan.
Healing Colors
Some versions of MinIO used a color key as a way to differentiate objects with different healing statuses.
Changed in version mc: RELEASE.2024-11-17T19-35-25Z
The color meaning has been updated.
Green indicates the bucket is healthy.
Yellow indicates the bucket requires healing on one or more drives.
Red indicates one or more drives are unhealthy.
Grey indicates an indeterminate healing state.