lustre/doc/lctl-del_ost.8

   1 .TH lctl-del_ost 8 "2022-06-13" Lustre "configuration utilities"
   2 .SH NAME
   3 lctl-del_ost \- permanently delete OST records
   4 .SH SYNOPSIS
   5 .B lctl del_ost
   6 .RB "[ --dryrun ]"
   7 .RB --target
   8 .IR OST_LABEL
   9
  10 .SH DESCRIPTION
  11 .B lctl del_ost
  12 cancels the config records for an OST specified by
  13 .I OST_LABEL
  14 to permanently forget about it. It should be run on the MGS and will
  15 search for the specified OST in the Lustre configuration log files for
  16 all MDTs and clients. If
  17 .RB --dryrun
  18 is not specified, it will modify the configuration log files to
  19 permanently disable the OST records. Newly mounted MDTs and clients
  20 will not process deleted OSTs anymore. This method allows to permanently
  21 remove OSTs on a live filesystem without the use of --writeconf with
  22 .BR tunefs.lustre (8).
  23
  24 Before using this command, you probably want to migrate
  25 file objects still on the OST by using
  26 .BR lfs-migrate (1)
  27 or
  28 .BR lfs_migrate (1)
  29 and make sure that there are no remaining file objects on the
  30 OST by using
  31 .BR lfs-find (1)
  32 which can find files by OST index.
  33 It is then recommended to first deactivate the OST using
  34 .BR lctl (8)
  35 with:
  36 .TP
  37 .B $ lctl conf_param lustre-OST0001.osc.active=0
  38 .TP
  39 and finally use \fBlctl del_ost\fR to remove it from the configuration logs.
  40 .TP
  41 .SH OPTIONS
  42 .TP
  43 \fB\-n\fR, \fB\-\-dryrun\fR
  44 An option provided so that the system administrator can see which
  45 records would have been cancelled, but without actually cancelling them.
  46 When deleting OST records, it is recommended to first use this option
  47 and check that there are no errors.
  48 .TP
  49 \fB\-t\fR, \fB\-\-target\fR
  50 This option is required and used to specify the OST label to permanently
  51 delete from the records. The target label should be of the form
  52 .BR "fsname-OST0a19" .
  53 .TP
  54 .SH EXAMPLES
  55 .TP
  56 .B $ lctl --device MGS del_ost --target lustre-OST0001
  57 .SH AVAILABILITY
  58 .B lctl del_ost
  59 is a subcommand of
  60 .BR lctl (8)
  61 and is distributed as part of the
  62 .BR lustre (7)
  63 filesystem package.
  64 .SH SEE ALSO
  65 .BR lctl (8),
  66 .BR lfs-find (1),
  67 .BR lfs-migrate (1),
  68 .BR lfs_migrate (1),
  69 .BR lctl-llog_cancel (8),
  70 .BR tunefs.lustre (8),
  71 .BR lustre (7)