How to manage storage pools

See also: Storage pool

This document shows how to work with storage pools.

Create a storage pool

First, check if your provider supports any storage configuration attributes. For example, in the case of AWS, the ebs storage provider supports several configuration attributes, and among these are volume-type, which configures the volume type (i.e. magnetic, ssd, or provisioned-iops), and iops, which indicates the IOPS per GiB.

Second, use the create-storage-pool command, passing as parameters the desired name of the pool and the name of the provider and then all the key-value pairs that you want to specify. For example, the code below creates a storage pool with the name iops which is a version of ebs with 30 IOPS.

juju create-storage-pool iops ebs volume-type=provisioned-iops iops=30

View the available storage pools

To view the available storage pools, use the storage-pools command:

juju storage-pools

This will list all the predefined storage pools as well as any custom ones that may have been created with the juju create-storage-pool command.

Note

The name given to a default storage pool will often be the same as the name of the storage provider upon which it is based.

````{dropdown} Expand to view a sample output for a newly-added aws model

Name     Provider  Attributes
ebs      ebs
ebs-ssd  ebs       volume-type=ssd
loop     loop
rootfs   rootfs
tmpfs    tmpfs


> See more: {ref}`command-juju-storage-pools`

## View the default storage pool

To find out the default storage pool for your block-type / filesystem-type, run the `model-config` command followed by the `storage-default-block-source` / `storage-default-filesystem-source` key. For example:

```text
juju model-config storage-default-block-source
```

> See more: {ref}`command-juju-model-config`, {ref}`storage-default-block-source`, {ref}`storage-default-filesystem-source` 


## Update a storage pool

To update storage pool attributes, use the `update-storage-pool` command:

```text
juju update-storage-pool test-pool
```

````{dropdown} Example


```text
# Update the storage-pool named iops with new configuration details:
juju update-storage-pool operator-storage volume-type=provisioned-iops iops=40

# Update which provider the pool is for:
juju update-storage-pool lxd-storage type=lxd-zfs
```

Remove a storage pool

To remove an existing storage pool, use the remove-storage-pool command:

juju remove-storage-pool test-pool