<a id="manage-storage-pools"></a>

# How to manage storage pools

See also: [Storage pool](https://documentation.ubuntu.com/juju/4.0/reference/storage.md#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.

See more: [Storage provider](https://documentation.ubuntu.com/juju/4.0/reference/storage.md#storage-provider) > `ebs`, [Wikipedia | IOPS](https://en.wikipedia.org/wiki/IOPS)

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.

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

See more: [juju create-storage-pool](https://documentation.ubuntu.com/juju/4.0/reference/juju-cli/list-of-juju-cli-commands/create-storage-pool.md#command-juju-create-storage-pool)

## View the available storage pools

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

```text
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.

### Expand to view a sample output for a newly-added aws model

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

See more: [juju storage-pools](https://documentation.ubuntu.com/juju/4.0/reference/juju-cli/list-of-juju-cli-commands/storage-pools.md#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: [juju model-config](https://documentation.ubuntu.com/juju/4.0/reference/juju-cli/list-of-juju-cli-commands/model-config.md#command-juju-model-config), [storage-default-block-source](https://documentation.ubuntu.com/juju/4.0/reference/configuration/list-of-model-configuration-keys.md#model-config-storage-default-block-source), [storage-default-filesystem-source](https://documentation.ubuntu.com/juju/4.0/reference/configuration/list-of-model-configuration-keys.md#model-config-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
```

### 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
```

---

See more: [juju update-storage-pool](https://documentation.ubuntu.com/juju/4.0/reference/juju-cli/list-of-juju-cli-commands/update-storage-pool.md#command-juju-update-storage-pool)

## Remove a storage pool

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

```text
juju remove-storage-pool test-pool
```

See more: [juju remove-storage-pool](https://documentation.ubuntu.com/juju/4.0/reference/juju-cli/list-of-juju-cli-commands/remove-storage-pool.md#command-juju-remove-storage-pool)