lustre/doc/lctl-pool_new.8

   1 .TH LCTL-POOL_NEW 8 "2018-12-12" Lustre "Lustre Utilities"
   2 .SH NAME
   3 lctl-pool_new \- create a new OST pool
   4 .SH SYNOPSIS
   5 .BR "lctl pool_new" " [" --nowait | -n "] "
   6 .IR <fsname> . <pool>
   7
   8 .SH DESCRIPTION
   9 Create a list of OSTs with the name
  10 .I poolname
  11 in the filesystem named
  12 .IR fsname .
  13 The
  14 .B lctl pool_new
  15 command must be run on the MGS node and can only be used by the
  16 root user.
  17
  18 .BR NOTE:
  19 After updating the MGS configuration, this command tries to wait and
  20 check if pools are updated on a client.
  21 If the MGS is on a separate node from the MDS, a Lustre client must
  22 be mounted on the MGS node while the
  23 .B lctl
  24 commands are being run for this. Otherwise, the client check is
  25 skipped.
  26
  27 This named list of OSTs can be used by
  28 .BR lfs-setstripe (1)
  29 to specify the OSTs on which new files can be created, and
  30 .BR lfs-find (1)
  31 to locate files that were created on the specified pool.  As well,
  32 .BR lfs-df (1)
  33 can show only the free space or inodes in a named pool.
  34
  35 .SH OPTIONS
  36 .TP
  37 .BR -n ", " --nowait
  38 Do not wait and check if pool is updated on a client. This is useful
  39 when calling a lot of "
  40 .B lctl
  41 pool_*" in a row. This avoids revoking the clients "CONFIG" lock for each
  42 command (by default clients retake their lock and update their configurations
  43 in a delay between 5-10s).
  44
  45 .SH EXAMPLES
  46 .TP
  47 .B # lfs pool_new testfs.local
  48 Create a pool named
  49 .B local
  50 in the
  51 .B testfs
  52 filesystem.
  53 .TP
  54 .B # lfs pool_add testfs.local 12 13 14
  55 Add OSTs numbered 12, 13, and 14 to the
  56 .B testfs.local
  57 pool.
  58
  59 .SH SEE ALSO
  60 .BR lctl (8),
  61 .BR lctl-pool_add (8),
  62 .BR lfs-df (1),
  63 .BR lfs-find (1),
  64 .BR lfs-setstripe (1),
  65 .BR lustre (7)