lctl-del_ost(8)

NAME
lctl-del_ost - permanently delete OST records

SYNOPSIS
lctl del_ost [ --dryrun ] --target OST_LABEL

DESCRIPTION
lctl del_ost cancels the config records for an OST specified by OST_LABEL to permanently forget about it. It should be run on the MGS and will search for the specified OST in the Lustre configuration log files for all MDTs and clients. If --dryrun is not specified, it will modify the configuration log files to permanently disable the OST records. Newly mounted MDTs and clients will not process deleted OSTs anymore. This method allows to permanently remove OSTs on a live filesystem without the use of --writeconf with tunefs.lustre(8). Before using this command, you probably want to migrate file objects still on the OST by using lfs-migrate(1) or lfs_migrate(1) and make sure that there are no remaining file objects on the OST by using lfs-find(1) which can find files by OST index. It is then recommended to first deactivate the OST using lctl(8) with:

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

and finally use lctl del_ost to remove it from the configuration logs.

OPTIONS

-n, --dryrun
    An option provided so that the system administrator can see which records would have been cancelled, but without actually cancelling them. When deleting OST records, it is recommended to first use this option and check that there are no errors.

-t, --target
    This option is required and used to specify the OST label to permanently delete from the records. The target label should be of the form fsname-OST0a19.

EXAMPLES

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

AVAILABILITY
lctl del_ost is a subcommand of lctl(8) and is distributed as part of the lustre(7) filesystem package.

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