Viewing: lctl-lcfg_erase.8
.TH LCTL-LCFG_ERASE 8 2026-03-27 Lustre "Lustre Configuration Utilities"
.SH NAME
lctl-lcfg_erase \- erase filesystem config llog
.SH SYNOPSIS
.SY "lctl lcfg_erase"
.RB [ -h | \-\-help "] [" -q | \-\-quiet ]
.I FSNAME
.YS
.SH DESCRIPTION
.B lcfg_erase
(alias
.BR erase_lcfg )
permanently erases the configuration for the filesystem named
.IR FSNAME .
The MGS should be mounted when this command is run. It can be used to
remove the backup configuration or delete inactive filesystem (or snapshot)
from a shared MGS.
It will also erase the persistent parameters that contain
.I FSNAME
in their name from the
.B params
configuration log.
This command must be run on the MGS node with the MGS device mounted.
.SH OPTIONS
.TP
.BR -h ", " --help
Show a brief usage message.
.TP
.BR -q ", " --quiet
Suppress informational messages about erased parameters.
.SH EXAMPLES
To erase all configuration logs and persistent params for filesystem
.BR testfs ,
including parameters like
.BR mdt.testfs-MDT0000.hsm_control :
.RS
.EX
.B mgs# lctl lcfg_erase testfs
.EE
.RE
.PP
To check the available configuration logs and configuration parameters that
will be erased, run the following commands on the MGS node:
.EX
.RS
.B mgs# lctl llog_catlist | grep testfs
.B mgs# lctl llog_print params | grep testfs
.RE
.EE
.SH AVAILABILITY
.B lctl-lcfg_erase
is part of the
.BR lustre (7)
filesystem package since release 2.10.0
.\" Added in commit v2_9_54_0-28-g61718da8ba
.SH SEE ALSO
.BR lctl (8),
.BR lctl-lcfg_clear (8),
.BR lctl-lcfg_fork (8),
.BR lctl-llog_catlist (8),
.BR lctl-llog_print (8),
.BR lctl-snapshot-create (8),
.BR lctl-snapshot-destroy (8)
