minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-08-08 01:43:18 +03:00
Code Activity
Files
relax-event-restriction
docs/source/reference/minio-mc-admin/mc-admin-heal.rst
Daryl White 5006f1f2b9 MC updates for two releases. (#1382) 
- Adds mc support top rpc command
- Adds information about new mc support inspect file names

Closes #1361

- Updates healing color meaning.

Closes #1371
2024-12-06 12:33:39 -05:00

2.6 KiB
Raw Permalink Blame History

mc admin heal

minio

Table of Contents

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 or GET operation.
  • performs periodic background object healing using the scanner <minio-concepts-scanner>.
  • aggressively heals objects after drive replacement.

Refer to minio-concepts-healing for more details on how MinIO heals objects.

Use mc admin on MinIO Deployments Only

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

The full path to the bucket or bucket prefix on which the command should perform object healing. Specify the alias <mc 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.

--all-drives, -a

Select all drives and show verbose information.

--force

Disables warning prompts.

--verbose, -v

Show information about offline and faulty healing drives.

Healing Colors

Some versions of MinIO used a color key as a way to differentiate objects with different healing statuses.

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.