LCTL-NODEMAP-SET-FILESET(8)

✨ NAME ✨

bestie, this is lctl-nodemap_set_fileset (section 8 of the Lustre Configuration Utilities manual, if you were wondering) — and what it does is add a fileset to a nodemap. that's the whole vibe 💖

---

🌸 SYNOPSIS 🌸

[[deprecated]] lctl nodemap_set_fileset or
[[deprecated]] lctl nodemap set_fileset --name NODEMAP --fileset
                                        SUBDIRECTORY

okay so notice the [[deprecated]] up there? yeah. twice. it's giving legacy, and we're gonna talk about that. 😭

---

💅 DESCRIPTION 💅

note: since Lustre 2.16.56, this command is deprecated, and it only affects the primary fileset. it's likely to disappear altogether in a future Lustre release. adding and deleting filesets should now be handled by lctl nodemap_fileset_{add/del}, respectively. mourn her but move on 🫶

so here's the tea: nodemap_set_fileset adds FILESET to the specified NODEMAP. the SUBDIRECTORY must begin with / — no exceptions, no shortcuts, she is strict about this. clients that belong to NODEMAP get automatically presented the corresponding SUBDIRECTORY when they mount. which basically means ✨ these clients are doing an implicit subdirectory mount on the subdirectory represented by the defined SUBDIRECTORY. lowkey iconic, highkey deprecated. 🦋

---

🎀 OPTIONS 🎀

• --name NODEMAP — the name of the nodemap that this fileset should be associated with. that's your NODEMAP right there, name it correctly bestie 💜
• --fileset SUBDIRECTORY — the fileset to restrict the clients to. must begin with /. i said what i said. 🌈

---

🍓 EXAMPLES 🍓

set and remove a fileset to nodemaps:

# lctl nodemap_set_fileset --name tenant1 --fileset '/dir1'
# lctl nodemap_set_fileset --name admins --fileset ''

see how the second one is just ''? that's the removal energy — empty fileset, fileset gone, no cap. 💀✨

---

⭐ AVAILABILITY ⭐

lctl nodemap_set_fileset is part of the lustre(7) filesystem package since release 2.9.0. she's been around a minute, okay. 💖

---

👑 SEE ALSO 👑

lustre(7), lctl-nodemap-activate(8), lctl-nodemap-add-idmap(8), lctl-nodemap-add-range(8), lctl-nodemap-del(8), lctl-nodemap-del-idmap(8), lctl-nodemap-del-range(8), lctl-nodemap-fileset-add(8), lctl-nodemap-fileset-del(8), lctl-nodemap-modify(8) lctl-nodemap-new(8),

(the whole nodemap friend group, fr fr 🫶 — go read lctl-nodemap-fileset-add(8) and lctl-nodemap-fileset-del(8) since those are the main characters now)

---

k bye bestie!! 💖✨🌸 this page is from Lustre, dated 2024-12-24, and it lives in the LCTL-NODE...T_FILESET(8) part of the manual. go forth and mount responsibly 🎀🦋💜