mc admin decommission

Syntax

The mc admin decommission command starts the decommissioning process for a AIStor 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. AIStor 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 Server Pools for a complete procedure on decommissioning a server pool.

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

This command supports any of the global flags.

Examples

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

All rights reserved 2024-Present, MinIO, Inc.