LCTL-POOL\_NEW(8) Lustre Configuration Utilities LCTL-POOL\_NEW(8)

# [NAME](#NAME)

lctl-pool\_new - create a new named list of OSTs

# [SYNOPSIS](#SYNOPSIS)

`lctl pool_new` \[**--nowait**|**-n**] *FSNAME*.*POOLNAME*

# [DESCRIPTION](#DESCRIPTION)

Create a list of OSTs with the name *POOLNAME* in the filesystem named *FSNAME*. The **lctl pool\_new** command must be run on the MGS node and can only be used by the root user.

The *POOLNAME* must be 15 or fewer alphanumeric characters ('A-Za-z0-9'), and may contain hyphen ('-') and underscore ('\_') characters. The period ('.') character can only be used to separate the *FSNAME* from the *POOLNAME* in commands to uniquely identify the pool when multiple filesystems are mounted on a node. The pool name must not be one of the reserved keywords '**none**', '**ignore**', or '**inherit**'.

# [NOTES](#NOTES)

After updating the MGS configuration, this command will wait up to 12s and check if pools are updated on a client, unless the **--nowait** option is used. If the MGS is on a separate node from the MDS, a Lustre client must be mounted on the MGS node while the **lctl** commands are being run for this. Otherwise, the client check is skipped.

This named list of OSTs can be used by [**lfs-setstripe**(1)](/man/enterprise-packages/lustre/lfs-setstripe.1) to specify the OSTs on which new files can be created, and [**lfs-find**(1)](/man/enterprise-packages/lustre/lfs-find.1) to locate files that were created on the specified pool. As well, [**lfs-df**(1)](/man/enterprise-packages/lustre/lfs-df.1) can show only the free space or inodes in a named pool. The [**lfs-quota**(1)](/man/enterprise-packages/lustre/lfs-quota.1) and [**lfs-setquota**(1)](/man/enterprise-packages/lustre/lfs-setquota.1) commands can use a pool name to get/set a quota limit for OSTs in the pool.

# [OPTIONS](#OPTIONS)

[**-n**, **--nowait**](#n)

Do not wait and check if pool is updated on a client. This is useful when calling a lot of '**lctl pool\_\***' commands in a row, to avoid waiting for each command to complete.

# [EXAMPLES](#EXAMPLES)

Create a pool named **flash** in the **testfs** filesystem:

```
# lfs pool_new testfs.flash
```

Add OSTs numbered 8, 10, and 12 through 14 to the **testfs.flash** pool:

```
# lfs pool_add testfs.flash 8 10 12-14
```

# [AVAILABILITY](#AVAILABILITY)

**lctl pool\_new** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 1.7.0

# [SEE ALSO](#SEE_ALSO)

[**lustre**(7)](/man/enterprise-packages/lustre/lustre.7), [**lctl**(8)](/man/enterprise-packages/lustre/lctl.8), [**lctl-pool\_add**(8)](/man/enterprise-packages/lustre/lctl-pool_add.8), [**lfs-df**(1)](/man/enterprise-packages/lustre/lfs-df.1), [**lfs-find**(1)](/man/enterprise-packages/lustre/lfs-find.1), [**lfs-setquota**(1)](/man/enterprise-packages/lustre/lfs-setquota.1), [**lfs-setstripe**(1)](/man/enterprise-packages/lustre/lfs-setstripe.1)

2025-05-01 Lustre

---

Document: lctl-pool_new(8) from lustre 2.17.60-r0 (Chainguard OS)
Source: https://github.com/lustre/lustre-release