dpm-drain man page

DPM-DRAIN(1)              DPM Administrator Commands              DPM-DRAIN(1)

[1mNAME[0m
      dpm-drain - drain a component of the Light Weight Disk Pool Manager

[1mSYNOPSIS[0m
      [1mdpm-drain  --poolname [4m[22mpool_name[24m [ [1m--server [4m[22mfs_server[24m ] [ [1m--gid [4m[22mgids[24m ] [
      [1m--group [4m[22mgroups[24m ] [ [1m--size [4m[22mamount_to_drain[24m ]

      [1mdpm-drain --server [4m[22mfs_server[24m [ [1m--gid [4m[22mgids[24m ] [ [1m--group [4m[22mgroups[24m ] [ [1m--size[0m
      [4mamount_to_drain[24m ]

      [1mdpm-drain  --server  [4m[22mfs_server[24m  [1m--fs  [4m[22mfs_name[24m  [ [1m--gid [4m[22mgids[24m ] [ [1m--group[0m
      [4mgroups[24m ] [ [1m--size [4m[22mamount_to_drain[24m ]

      [1mdpm-drain --help[0m

[1mDESCRIPTION[0m
      [1mdpm-drain [22mdrains a component of the Light Weight Disk Pool  Manager:  a
      filesystem,  a  disk server or a pool, optionally filtered by a list of
      gids/groups. It replicates files which belong  to  the  given  list  of
      gids/groups (if specified) to another filesystem and removes the origi-
      nal file. It gives an error message for files still  pinned.  The  pool
      name, the disk server name or the filesystem name can be specified.

      [1mVolatile  [22mfiles  which  have  expired  will  not  be copied and will be
      [1mdeleted [22mduring the draining process.

      If no specfic file server and file system is specified, or no limit  is
      placed  on  the files to drain, then the involved active file system(s)
      will have their status changed to [1mRDONLY.  [22mIf any of the involved  file
      systems are marked as [1mDISABLED [22mthey will not have their status changed,
      however an attempt will still be made to replicate the files from  them
      and, if successful, delete the original.

      Files  which  are  to be moved and belong to a space will be moved to a
      different location (e.g. file system or disk server) but remain in  the
      same  space. If there is no alternate location within the same space an
      error will be reported for the file and it will not be drained.

      Replicas of files with a lifetime will also have lifetime at  least  as
      long  as  the  original. If this is not possible (for example available
      pools have a maximum lifetime too short) then an error is given and the
      file will not be drained.

      This command requires ADMIN privilege.

      [4mpool_name[0m
             specifies  the  disk  pool  name  previously  defined using [1mdpm-[0m
             [1maddpool[22m.

      [4mserver[24m specifies the host name of the disk server to be drained.

      [4mfs[24m     specifies the mount point of the dedicated filesystem.

      [4mgid[24m    specifies the comma separated list of gids to  which  the  files
             must belong.

      [4mgroup[24m  specifies  the comma separated list of groups to which the files
             must belong.

      [4msize[24m   specifies the minimum number of bytes to drain. The  number  may
             be  post-fixed with 'k', 'M', 'G' or 'T' for kilobyte, Megabyte,
             Gigabyte and Terabyte respectively.  Draining is halted once the
             desired target has been reached or passed.  If size is not spec-
             ified or is given as zero  dpm-drain  will  drain  all  eligible
             files.

[1mEXAMPLE[0m
           setenv DPM_HOST dpmhost
           setenv DPNS_HOST dpnshost

           dpm-drain --poolname Permanent

           dpm-drain --server lxb1921.cern.ch

           dpm-drain --server lxb1921.cern.ch --fs /storage

           dpm-drain --poolname Permanent --gid 105

           dpm-drain --server lxb1921.cern.ch --group dteam

           dpm-drain --server lxb1921.cern.ch --gid 105,104

[1mEXIT STATUS[0m
      This  program  returns  0  if the operation was successful or >0 if the
      operation failed.

[1mSEE ALSO[0m
      [1mdpm(1)[22m, [1mdpm-qryconf(1)[0m

LCG          $Date: 2010-04-20 09:11:48 +0200 (Tue, 20 Apr 2010) $DPM-DRAIN(1)