LCTL-DEL_OST(8)

💅 LCTL-DEL_OST 💅

okay bestie, we're in the Lustre Configuration Utilities section of the manual, page LCTL-DEL_OST(8), and this one is literally about permanently deleting OST records. no takebacks. let's go 🦋

---

✨ NAME ✨

lctl-del_ost — permanently delete OST records 🗑️✨

---

🌸 SYNOPSIS 🌸

lctl del_ost [--dryrun] --target OST_LABEL

---

🎀 DESCRIPTION 🎀

so lctl del_ost cancels the config records for an OST that you name with OST_LABEL, so the system permanently forgets about it. periodt. 💀

run this on the MGS, bestie, because it's gonna go search for that OST in the Lustre configuration log files for all MDTs and clients. all of them. it's thorough like that. 👑

if you don't pass --dryrun, it will actually modify the configuration log files to permanently disable the OST records. and then? newly mounted MDTs and clients just won't process deleted OSTs anymore. bye girl 👋

the whole point of this method is that it lets you permanently remove OSTs on a live filesystem — no --writeconf with tunefs.lustre(8) required. iconic behaviour, honestly ✨

🫶 before you run this, bestie, you probably want to migrate the file objects still sitting on the OST using lfs-migrate(1), and make sure there are no remaining file objects on the OST using lfs-find(1) — that one can find files by OST index. do your homework. 📚

then it's recommended that you first deactivate the OST using lctl(8), like this:

# lctl conf_param lustre-OST0001.osc.active=0

and finally use lctl del_ost to remove it from the configuration logs. the order matters, okay? trust. 💜

---

✨ OPTIONS ✨

• -n, --dryrun — a little preview mode so the system administrator can see which records would have been cancelled, without actually cancelling anything. 🕵️‍♀️ when you're deleting OST records, it is recommended to run this first and check that there are no errors. no cap.
• -t, --target — this one is required and it's how you specify the OST label to permanently delete from the records. the target label should be of the form fsname-OST0a19. like, literally that shape. 🌈

---

🌟 EXAMPLES 🌟

# lctl --device MGS del_ost --target lustre-OST0001

ate. 💅

---

💖 AVAILABILITY 💖

lctl del_ost is a subcommand of lctl(8) and is distributed as part of the lustre(7) filesystem package since release 2.11.0. so it's not new-new, but it's still that girl. 👑

---

🦋 SEE ALSO 🦋

lfs-find(1), lfs-migrate(1), lustre(7), lctl(8), lctl-llog_cancel(8), tunefs.lustre(8),

---

Lustre · 2024-08-13 · and that's the whole page, bestie!! go delete responsibly, mwah 💖🫶✨