LCTL-POOL_NEW(8)

📦 version 2.17.58, in ubuntu stonking

💖 LCTL-POOL_NEW 💖

okay bestie, welcome to lctl-pool_new from the Lustre Configuration Utilities section (that's section 8, system admin girlies only 💅). this is the page where we learn how to make a whole brand-new named list of OSTs. let's get into it 🦋

✨ NAME ✨

lctl-pool_new — create a new named list of OSTs 🌸

🫶 SYNOPSIS 🫶

lctl pool_new [--nowait|-n] FSNAME.POOLNAME

👑 DESCRIPTION 👑

so the whole vibe here is: you're creating a list of OSTs, and you're naming it POOLNAME, and it lives inside the filesystem named FSNAME. 🪩

Important scheduling note: the lctl pool_new command must be run on the MGS node and honestly it can only be used by the root user. no exceptions, no sneaking in 🙈

okay now let's talk about what POOLNAME is allowed to be, because there are rules:

  • It must be 15 or fewer alphanumeric characters ('A-Za-z0-9') — short and sweet, we love a concise queen
  • It may also contain a hyphen ('-') and an underscore ('_') 🎀
  • The period ('.') character can only be used to separate the FSNAME from the POOLNAME in commands — the reason is so you can uniquely identify the pool when multiple filesystems are mounted on a node. like a little last-name situation, iykyk
  • And POOLNAME must not be one of the reserved keywords 'none', 'ignore', or 'inherit'. those three are taken, periodt 💀

🌈 NOTES 🌈

so after updating the MGS configuration, this command is gonna wait up to 12s and check if pools are updated on a client — unless you used the --nowait option. 🕐

and here's the little catch bestie: 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 just skipped. no drama, it just moves on 🙈

now, what is this named list of OSTs actually for? obsessed that you asked:

  • lfs-setstripe(1) can use it to specify the OSTs on which new files can be created 🍓
  • lfs-find(1) can use it to locate files that were created on the specified pool 🔍
  • lfs-df(1) can show only the free space or inodes in a named pool 👑
  • and lfs-quota(1) and lfs-setquota(1) 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 highkey useful when you're calling a lot of 'lctl pool_*' commands in a row, because it saves you from waiting for each command to complete. efficiency icon behavior fr fr 🔥

💅 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 🫶 — she's been around, she's got history, she's iconic.

🌸 SEE ALSO 🌸

and that's the whole page bestie!! this one came to you from Lustre, dated 2025-05-01, and it's filed under LCTL-POOL_NEW(8) — go forth and pool responsibly, mwah 💖🎀🦋

📦 where this page comes from