Skip to main content

Drive Pools

Drive Pools

A drive pool is a group of drives that StorONE spreads a volume's erasure-coded data across. Every volume lives on at least one pool (see Volumes), so before you can create your first volume, you need at least one pool with approved drives in it.

StorONE maintains two kinds of pools:

  • Automatic pools —— as you approve drives (see Drives), StorONE automatically places them into a pool for their drive type (HDD, SSD, or NVMe) without any extra steps on your part. For most deployments, this is all you need.
  • Manual pools —— a named pool you create yourself, so you can control exactly which drives end up grouped together rather than letting the system group them purely by drive type. Common reasons to use a manual pool: keeping a specific application's data on a physically isolated set of drives, or separating drives into different fault/performance domains.

Drives are only added to a manual pool at the point you approve or revive them —— see Drives for how to point an approval at a specific manual pool. Creating the pool itself just reserves the name; it starts out empty.

Listing pools

Using the web interface

Open Inventory > Resources > Pools. The list shows every pool, automatic and manual. Use the toolbar to include the drives in each pool, the volumes built on each pool, and basic capacity usage.

Using the CLI

resources drives pools list [--drives] [--volumes] [--capacity]
Option Description
--drives Include the drives in each pool.
--volumes Include the volumes in each pool.
--capacity Show basic capacity information.

Examples

List all pools with their capacity usage:

resources drives pools list --capacity

List all pools along with which drives and volumes belong to each:

resources drives pools list --drives --volumes

Creating a manual pool

Create a manual pool when you want to control exactly which drives get grouped together, instead of letting StorONE automatically group approved drives by type. A manual pool only needs a name —— you populate it afterward by approving (or reviving) drives directly into it.

Using the web interface

  1. Open Inventory > Resources > Pools.
  2. Click Create.
  3. Under Name, enter the new pool's name.
  4. Confirm to create the pool.

Using the CLI

resources drives pools create --name=<name>
Option Description
--name=<name> The name of the manual pool.

Example —— create an empty manual pool named finance-pool, to later approve a dedicated set of drives into:

resources drives pools create --name finance-pool

Renaming a manual pool

Only manual pools can be renamed —— automatic pools are managed entirely by the system.

Using the web interface

  1. Open Inventory > Resources > Pools.
  2. Select the manual pool and click Edit.
  3. Under Pool Selection, update the pool name.
  4. Confirm the change.

Using the CLI

resources drives pools edit --name=<name> [--newName=<name>]
Option Description
--name=<name> The name of the manual pool to edit.
--newName=<name> The new name of the manual pool.

Example —— rename finance-pool to finance-archive:

resources drives pools edit --name finance-pool --newName finance-archive

Deleting a manual pool

A manual pool can only be deleted while it's empty —— if it still has drives assigned to it, remove/reassign those drives first. Only manual pools can be deleted; automatic pools are removed automatically once they have no drives left.

Using the web interface

  1. Open Inventory > Resources > Pools.
  2. Select the manual pool and click Delete.
  3. Confirm the deletion.

Using the CLI

resources drives pools delete --name=<name>
Option Description
--name=<name> The name of the manual pool to delete.

Example

resources drives pools delete --name finance-pool

Next: Drives —— approving, unapproving, reviving, and locating the physical drives that make up a pool.

See also: Resources overview ·· Volumes —— building volumes on top of a pool.