LCTL-LCFG_ERASE(8)

πŸ“¦ version 2.17.58, in ubuntu stonking

πŸ’– LCTL-LCFG_ERASE πŸ’–

okay so bestie, we're deep in the lctl-lcfg_erase corner of the Lustre Configuration Utilities manual (that's the LCTL-LCFG_ERASE(8) page, section 8, iykyk) and honestly? it's giving "registry cleanup but make it ✨dramatic✨". grab a snack, we're doing filesystem config erasure and we're doing it correctly. πŸŽ€


✨ NAME ✨

lctl-lcfg_erase β€” erase filesystem config llog 🧹✨


🌸 SYNOPSIS 🌸

lctl lcfg_erase [-h|--help] [-q|--quiet] FSNAME

πŸ¦‹ DESCRIPTION πŸ¦‹

lcfg_erase (and yes, its alias is erase_lcfg, same girl different name πŸ’…) permanently erases the configuration for the filesystem named FSNAME. like, gone gone. no undo button. 😭

the MGS should be mounted when you run this command. lowkey important.

so what's it even for? it can be used to:

  • remove the backup configuration 🌈
  • delete an inactive filesystem (or snapshot) from a shared MGS πŸ’€

and it will also erase the persistent parameters that contain FSNAME in their name from the params configuration log. so it's not just one thing, it's a whole cleanup moment. ✨

the rules bestie: this command must be run on the MGS node with the MGS device mounted. no shortcuts, no "I'll just run it from here", nope. 🫢

πŸ’… OPTIONS πŸ’…

  • -h, --help β€” shows you a brief usage message. the "what do I even type" helper πŸ₯Ί
  • -q, --quiet β€” suppresses the informational messages about erased parameters. for when you want your terminal to be as silent as your situationship πŸ™ˆ

⭐ EXAMPLES ⭐

erasing everything for a filesystem 🌸

to erase all configuration logs and persistent params for filesystem testfs, including parameters like mdt.testfs-MDT0000.hsm_control:

mgs# lctl lcfg_erase testfs

peeking before you yeet πŸ‘€

to check the available configuration logs and configuration parameters that will be erased, run the following commands on the MGS node:

mgs# lctl llog_catlist | grep testfs
mgs# lctl llog_print params | grep testfs

like, look before you delete. main character move fr fr. πŸ‘‘


🌈 AVAILABILITY 🌈

lctl-lcfg_erase is part of the lustre(7) filesystem package since release 2.10.0. it's been here, it's been serving. πŸ’–


πŸŽ€ SEE ALSO πŸŽ€


and that's the whole page bestie!! πŸ¦‹ no cap. this one came straight out of Lustre, dated 2026-03-27 β€” so if you ever forget where you read all this, that's the source and the date, written right there in the footer like a little signature. slay, go erase responsibly, and pls pls pls double check your FSNAME before you hit enter πŸ’œβœ¨

πŸ“¦ where this page comes from