lustre/doc/lctl-pool_add.8

   1 .TH LCTL-POOL_ADD 8 2018-10-27 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lctl pool_add \- add OSTs to a named pool
   4 .SH SYNOPSIS
   5 .B lctl pool_add \fI<fsname>.<poolname>\fR \fI<ost_index> ...\fR
   6 .br
   7 .B lctl pool_add \fI<fsname>.<poolname>\fR \fI<ost_range> ...\fR
   8
   9 .SH DESCRIPTION
  10 Add one or more OSTs to the pool named
  11 .I poolname
  12 in the filesystem named
  13 .IR fsname .
  14 There are several formats that the OSTs can be specified.  Simplest is
  15 to just specify a list of
  16 .RI < ost_index >
  17 numbers or OST names.  It is also possible to specify an
  18 .RI < ost_range >
  19 expression of the form
  20 .BI [ start - end ]
  21 or
  22 .BI [ start - end / step ]
  23 that adds multiple OSTs with index numbers in the range from
  24 .I start
  25 to
  26 .I end
  27 (inclusive), optionally skipping every
  28 .I step
  29 index values.  The
  30 .B lctl pool_add
  31 command must be run on the MGS node and can only be used by the
  32 root user.  If the MGS is on a separate node from the MDS, a
  33 Lustre client must be mounted while the
  34 .B lctl
  35 commands are being run.
  36
  37 The OST pool can be used by
  38 .BR lfs-setstripe (1)
  39 to specify the OSTs on which new files can be created, and
  40 .BR lfs-find (1)
  41 to locate files that were initially created on the specified
  42 .IR poolname .
  43 Note however, that the OSTs that make up a specific pool may change
  44 over time, and it is the
  45 .I poolname
  46 used at creation time that is stored on each file, not necessarily
  47 OSTs that are in the current pool.  As well,
  48 .BR lfs-df (1)
  49 can show only the free space or inodes in a named pool.
  50
  51 .SH EXAMPLES
  52 .TP
  53 .B # lfs pool_new testfs.local
  54 Create a pool named
  55 .B local
  56 in the
  57 .B testfs
  58 filesystem.
  59 .TP
  60 .B # lfs pool_add testfs.local 12 13 14
  61 Add OSTs numbered 12, 13, and 14 to the
  62 .B testfs.local
  63 pool.
  64
  65 .SH SEE ALSO
  66 .BR lctl (8),
  67 .BR lctl-pool_new (8),
  68 .BR lfs-df (1),
  69 .BR lfs-find (1),
  70 .BR lfs-setstripe (1),
  71 .BR lustre (7)