mc admin heal

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.
aggressively heals objects after drive replacement.

Refer to Object Healing for more details on how AIStor heals objects.

Syntax

Example Syntax

The command has the following syntax:

mc admin heal [FLAGS] TARGET             \
                      [--all-drives, -a] \
                      [--force]          \
                      [--verbose, -v]

Brackets [] indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

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 AIStor 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

Alias: -a

Optional

Select all drives and show verbose information.

--force

Optional

Disables warning prompts.

--verbose

Alias: -v

Optional

Show information about offline and faulty healing drives.

Behavior

Healing of multiple drives in an erasure set occurs only one drive at a time

If multiple drives within the same erasure set require healing, AIStor prioritizes the first drive that begins healing within the erasure set. Other drives in the erasure set wait until healing finishes on the first drive before the next drive starts healing.

This allows drives that begin healing to complete the process as quickly as possible.

Healing Colors

You may come across a generated table with green, yellow, red, and gray colors to indicate the healing status of individual objects.

The following table describes the meaning of the now-deprecated status colors.

Green	Healthy, the object has all data and parity shards available as required to serve the object
Yellow	Healing, the object is still in the process of healing, and there are sufficient data or parity shards available to complete the healing
Red	Unhealthy, the object has lost one or more shards and requires healing
Grey	Unrecoverable, the object has lost too many data and/or parity shards and cannot be healed or recovered