lctl-pool_new(8)

NAME

lctl-pool_new - create a new named list of OSTs

SYNOPSIS

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

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) to specify the OSTs on which new files can be created, and lfs-find(1) to locate files that were created on the specified pool. As well, lfs-df(1) can show only the free space or inodes in a named pool. The lfs-quota(1) and lfs-setquota(1) commands can use a pool name to get/set a quota limit for OSTs in the pool.

OPTIONS

-n, --nowait

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

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

lctl pool_new is part of the lustre(7) filesystem package since release 1.7.0

SEE ALSO

lustre(7), lctl(8), lctl-pool_add(8), lfs-df(1), lfs-find(1), lfs-setquota(1), lfs-setstripe(1)