bm admin decommission
Syntax
The bm admin decommission command starts the decommissioning process for a
Buckit 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. Buckit 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.
Decommissioning is Permanent
Once Buckit 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.
bm 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
bm admin decommission startagain against the pool.
- ALIAS
Required The alias of the Buckit deployment on which to start the decommissioning process.
Global Flags
This command supports any of the global flags.
Examples
See Decommission Server Pools for a complete procedure on decommissioning a server pool.
