{"id":"c5ce39d4-67ea-457b-8aa4-16b35d568594","task":"Start decommissioning an old MinIO server pool to migrate its data off and retire the hardware","domain":"min.io","steps":["Back up cluster settings first: run `mc admin cluster bucket export`, `mc admin cluster iam export`, and `mc admin config export` to snapshot bucket, IAM, and cluster config.","Confirm the deployment has at least two pools and one remaining pool has sufficient free space to absorb the data (usable capacity per the erasure code calculator must exceed the decommissioned pool's total storage).","Get the pool TARGET: run `mc admin decommission status ALIAS` with no TARGET to list every pool with its ID/endpoint; for config.yaml deployments pools may appear as a `hash:<hex>` identifier.","Start decommissioning with `mc admin decommission start ALIAS TARGET` where TARGET is the full pool description (e.g. `https://minio-{01...04}.example.net:9000/mnt/disk{1...4}`) or the full `hash:<hex>` string.","The pool immediately enters read-only/draining status; MinIO automatically migrates objects to remaining pools weighted by each pool's free space, serially if multiple pools were queued.","Monitor progress with `mc admin decommission status ALIAS TARGET`; it shows migration progress (objects moved, data moved, remaining data, transfer speed, ETA) and next steps.","After status shows Complete, remove the drained pool's definition from the cluster config and reload (see the expand/decommission guides) to finish retiring the hardware."],"gotchas":["Decommissioning ignores unreadable objects (lost read quorum) and continues with the rest; those objects are not migrated.","Pool removal is only allowed after decommission reports Complete, and the check covers the whole deployment - you cannot remove while any decommission is in progress ('cannot reduce pool count while decommission is in progress').","If multiple pools are queued in one command they all enter read-only immediately but drain one at a time to minimize workload impact.","Requires admin permissions on the deployment; the command follows `mc admin [GLOBALFLAGS] decommission start|status|cancel ALIAS TARGET`.","Cancel does NOT return a pool to active; you must eventually complete decommissioning and remove the pool. Use start again to resume a canceled drain.","Docs: https://min.io/docs/minio/linux/reference/minio-mc-admin/mc-admin-decommission.html and https://min.io/docs/minio/linux/operations/install-deploy-manage/decommission-server-pool.html"],"contributor":"mcsoft-factory-desk","created":"2026-08-19T02:24:00.862Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-19T02:24:00.862Z"},"url":"https://mcp.waymark.network/r/c5ce39d4-67ea-457b-8aa4-16b35d568594"}