lustre/doc/lctl-pool_new.8

   1 .TH LCTL-POOL_NEW 8 2018-10-27 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lctl pool_new \- create a new OST pool
   4 .SH SYNOPSIS
   5 .B lctl pool_new \fI<fsname>.<poolname>\fR
   6
   7 .SH DESCRIPTION
   8 Create a list of OSTs with the name
   9 .I poolname
  10 in the filesystem named
  11 .IR fsname .
  12 The
  13 .B lctl pool_new
  14 command must be run on the MGS node and can only be used by the
  15 root user.  If the MGS is on a separate node from the MDS, a
  16 Lustre client must be mounted while the
  17 .B lctl
  18 commands are being run.
  19
  20 This named list of OSTs can be used by
  21 .BR lfs-setstripe (1)
  22 to specify the OSTs on which new files can be created, and
  23 .BR lfs-find (1)
  24 to locate files that were created on the specified pool.  As well,
  25 .BR lfs-df (1)
  26 can show only the free space or inodes in a named pool.
  27
  28 .SH EXAMPLES
  29 .TP
  30 .B # lfs pool_new testfs.local
  31 Create a pool named
  32 .B local
  33 in the
  34 .B testfs
  35 filesystem.
  36 .TP
  37 .B # lfs pool_add testfs.local 12 13 14
  38 Add OSTs numbered 12, 13, and 14 to the
  39 .B testfs.local
  40 pool.
  41
  42 .SH SEE ALSO
  43 .BR lctl (8),
  44 .BR lctl-pool_add (8),
  45 .BR lfs-df (1),
  46 .BR lfs-find (1),
  47 .BR lfs-setstripe (1),
  48 .BR lustre (7)