lustre/doc/lctl-pool_add.8

   1 .TH LCTL-POOL_ADD 8 "2018-12-12" Lustre "configuration utilities"
   2 .SH NAME
   3 lctl-pool_add \- add OSTs to a named pool
   4 .SH SYNOPSIS
   5 .BR "lctl pool_add" " [" --nowait | -n "] "
   6 .IR <fsname> . <pool> " "  <ost_index> " " ...
   7 .br
   8 .BR "lctl pool_add" " [" --nowait | -n "] "
   9 .IR <fsname> . <pool> " " <ost_range> " "...
  10
  11 .SH DESCRIPTION
  12 Add one or more OSTs to the pool named
  13 .I poolname
  14 in the filesystem named
  15 .IR fsname .
  16 There are several formats that the OSTs can be specified.  Simplest is
  17 to just specify a list of
  18 .RI < ost_index >
  19 numbers or OST names.  It is also possible to specify an
  20 .RI < ost_range >
  21 expression of the form
  22 .BI [ start - end ]
  23 or
  24 .BI [ start - end / step ]
  25 that adds multiple OSTs with index numbers in the range from
  26 .I start
  27 to
  28 .I end
  29 (inclusive), optionally skipping every
  30 .I step
  31 index values.
  32
  33 .BR NOTE:
  34 After updating the MGS configuration, this command tries to wait and
  35 check if pools are updated on a client.
  36 If the MGS is on a separate node from the MDS, a Lustre client must
  37 be mounted on the MGS node while the
  38 .B lctl
  39 commands are being run for this. Otherwise, the client check is
  40 skipped.
  41
  42 The OST pool can be used by
  43 .BR lfs-setstripe (1)
  44 to specify the OSTs on which new files can be created, and
  45 .BR lfs-find (1)
  46 to locate files that were initially created on the specified
  47 .IR poolname .
  48 Note however, that the OSTs that make up a specific pool may change
  49 over time, and it is the
  50 .I poolname
  51 used at creation time that is stored on each file, not necessarily
  52 OSTs that are in the current pool.  As well,
  53 .BR lfs-df (1)
  54 can show only the free space or inodes in a named pool.
  55
  56 .SH OPTIONS
  57 .TP
  58 .BR -n ", " --nowait
  59 Do not wait and check if pool is updated on a client. This is useful
  60 when calling a lot of "
  61 .B lctl
  62 pool_*" in a row. This avoids revoking the clients "CONFIG" lock for each
  63 command (by default clients retake their lock and update their configurations
  64 in a delay between 5-10s).
  65
  66 .SH EXAMPLES
  67 .TP
  68 .B # lfs pool_new testfs.local
  69 Create a pool named
  70 .B local
  71 in the
  72 .B testfs
  73 filesystem.
  74 .TP
  75 .B # lfs pool_add testfs.local 12 13 14
  76 Add OSTs numbered 12, 13, and 14 to the
  77 .B testfs.local
  78 pool.
  79
  80 .SH SEE ALSO
  81 .BR lctl (8),
  82 .BR lctl-pool_new (8),
  83 .BR lfs-df (1),
  84 .BR lfs-find (1),
  85 .BR lfs-setstripe (1),
  86 .BR lustre (7)