`mc admin decommission`

Table of Contents

Syntax
- Parameters
- Global Flags
Examples

Syntax

The mc admin decommission command starts the decommissioning process for a MinIO server pools. Decommissioning is designed for removing an older server pool whose hardware is no longer sufficient or performant compared to the pools in the deployment. MinIO automatically migrates data from the decommissioned pool to the remaining pools in the deployment based on the ratio of free space available in each pool.

See Decommission a Server Pool for a complete procedure on decommissioning a server pool.

Decommissioning is Permanent

Once MinIO begins decommissioning a pool, it marks that pool as permanently inactive (“draining”). Cancelling or otherwise interrupting the decommissioning procedure does not restore the pool to an active state.

Decommissioning is a major administrative operation that requires care in planning and execution, and is not a trivial or ‘daily’ task.

MinIO SUBNET users can log in and create a new issue related to decommissioning. Coordination with MinIO Engineering via SUBNET can ensure successful decommissioning, including performance testing and health diagnostics.

Community users can seek support on the MinIO Community Slack. Community Support is best-effort only and has no SLAs around responsiveness.

mc admin [GLOBALFLAGS] decommission start|status|cancel ALIAS TARGET

Parameters

start

Required Starts the decommissioning process for the server pool specified to TARGET.

Requires specifying TARGET

status

Required Returns the decommissioning status of all server pools on the specified ALIAS:

Active - The pool is active and not scheduled for decommissioning.
Draining - The pool is currently decommissioning.
Draining (Failed) - The decommissioning process failed and requires manually restart.
Draining (Cancelled) - The decommissioning process was manually cancelled.

If the command includes a TARGET, the command output includes the rate of data migration if decommissioning is in progress.

cancel

Required Cancels an ongoing decommissioning process on the pool specified to TARGET.

Requires specifying TARGET.

Cancelling a decommissioning process does not return the pool to an active state. You must eventually complete the decommissioning process and remove the pool from the deployment. You can resume the process by running mc admin decommission start again against the pool.

ALIAS: Required The alias of the MinIO deployment on which to start the decommissioning process.

TARGET

The full description of the server pool on which the command operates. For example:

https://minio-{01...04}.example.net:9000/mnt/disk{1...4}

Global Flags

--debug

Optional

Enables verbose output to the console.

For example:

mc --debug COMMAND

--config-dir: Optional
The path to a JSON formatted configuration file that mc uses for storing data. See Configuration File for more information on how mc uses the configuration file.

--JSON

Optional

Enables JSON lines formatted output to the console.

For example:

mc --JSON COMMAND

--no-color: Optional
Disables the built-in color theme for console output. Useful for dumb terminals.

--quiet: Optional
Suppresses console output.

--insecure: Optional
Disables TLS/SSL certificate verification. Allows TLS connectivity to servers with invalid certificates. Exercise caution when using this option against untrusted S3 hosts.

--version: Optional
Displays the current version of mc.

--help: Optional
Displays a summary of command usage on the terminal.

Examples

See Decommission a Server Pool for a complete procedure on decommissioning a server pool.