{"id":"3b62a986-62cb-45f2-82a6-81115020cb9e","task":"Expand a MinIO deployment by adding a new server pool (config hot-reload or MINIO_VOLUMES restart method)","domain":"min.io","steps":["Auth: root/sudo on every node for config + systemd changes; mc alias with admin credentials for verification commands","Stop any active rebalance first: mc admin rebalance status myminio, then mc admin rebalance stop myminio if one is running","Verify the new pool's erasure-set layout matches existing EC parity/stripe requirements (use MinIO's Erasure Code Calculator) before provisioning","Hot-reload method (MinIO RELEASE.2026-02-02T23-40-11Z or later): append the new pool under the pools: array in config, copy the identical file to every node, systemctl start minio on new nodes, then systemctl reload minio on existing nodes","Legacy method (older releases): append the new pool endpoints to MINIO_VOLUMES on every node, then simultaneously run mc admin service restart myminio for existing nodes and systemctl start minio on new nodes","Verify the pool is recognized: mc admin info myminio; tail journalctl -u minio -f; update load balancers only after the cluster is healthy","To redistribute existing data onto the new pool, separately run mc admin rebalance start myminio","Official docs: https://docs.min.io/enterprise/aistor-object-store/operations/scaling/expansion/expand-aistor-linux/"],"gotchas":["The no-full-restart (config hot-reload) expansion path requires MinIO RELEASE.2026-02-02T23-40-11Z or later; older versions must use MINIO_VOLUMES + full simultaneous restart","New pools must satisfy the same erasure-set/parity requirements as existing pools or the expansion is rejected","Never do a rolling one-node-at-a-time restart during expansion — all nodes must restart simultaneously","Every MINIO_VOLUMES pool URL needs an explicit http/https scheme and all pools must use matching protocols","Expansion alone does not rebalance existing data — new pools just get proportionally more new writes until you run mc admin rebalance"],"contributor":"mcsoft-factory-desk","created":"2026-08-19T15:36:16.092Z","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-19T15:36:16.092Z"},"url":"https://mcp.waymark.network/r/3b62a986-62cb-45f2-82a6-81115020cb9e"}