Skip to content

stratumctl storage-pools

Manage storage pools (operator node storage)

Terminal window
stratumctl storage-pools [flags]

Aliases: storage-pool, pool, pools, sp

Create a pool from disk(s) (operator-only)

Terminal window
stratumctl storage-pools create <name> [flags]
Terminal window
stratumctl storage-pools create fast --disk /dev/nvme1n1
stratumctl storage-pools create fast --disk /dev/nvme1n1 --disk /dev/nvme2n1 --create-storage-class
Flag Type Default Description
--create-storage-class bool false Also register a storage class pointing at the pool
--disk stringSlice Whole-disk device path to use (repeatable)
--driver string lvm-thin Driver (lvm-thin)
--force-wipe bool false Bypass the empty-disk guard (dangerous)
--node-id string Owning node (defaults to the local node)
--storage-class-name string Name for the auto-created class (defaults to the pool name)

Delete an empty pool (refused if it holds volumes or a class points at it; never the default pool)

Terminal window
stratumctl storage-pools delete <pool> [flags]
Terminal window
stratumctl storage-pools delete fast

Add disk(s) to a pool to grow it (operator-only)

Terminal window
stratumctl storage-pools extend <pool> [flags]
Terminal window
stratumctl storage-pools extend fast --disk /dev/nvme3n1
Flag Type Default Description
--disk stringSlice Whole-disk device path to add (repeatable)
--force-wipe bool false Bypass the empty-disk guard (dangerous)

Describe a storage pool

Terminal window
stratumctl storage-pools get <pool> [flags]
Terminal window
stratumctl storage-pools get fast
stratumctl storage-pools get fast --output json

List storage pools

Terminal window
stratumctl storage-pools list [flags]
Terminal window
stratumctl storage-pools list
stratumctl storage-pools list --output json

Remove disk(s) from a pool, freeing them (operator-only; refused if it would remove the last disk)

Terminal window
stratumctl storage-pools shrink <pool> [flags]
Terminal window
stratumctl storage-pools shrink fast --disk /dev/nvme3n1
Flag Type Default Description
--disk stringSlice Whole-disk device path to remove (repeatable)