1DPM-DRAIN(1)              DPM Administrator Commands              DPM-DRAIN(1)
2
3
4

NAME

6       dpm-drain - drain a component of the Light Weight Disk Pool Manager
7

SYNOPSIS

9       dpm-drain  --poolname pool_name [ --server fs_server ] [ --gid gids ] [
10       --group groups ] [ --size amount_to_drain ]
11
12       dpm-drain --server fs_server [ --gid gids ] [ --group groups ] [ --size
13       amount_to_drain ]
14
15       dpm-drain  --server  fs_server  --fs  fs_name  [ --gid gids ] [ --group
16       groups ] [ --size amount_to_drain ]
17
18       dpm-drain --help
19

DESCRIPTION

21       dpm-drain drains a component of the Light Weight Disk Pool  Manager:  a
22       filesystem,  a  disk server or a pool, optionally filtered by a list of
23       gids/groups. It replicates files which belong  to  the  given  list  of
24       gids/groups (if specified) to another filesystem and removes the origi‐
25       nal file. It gives an error message for files still  pinned.  The  pool
26       name, the disk server name or the filesystem name can be specified.
27
28       Volatile  files  which  have  expired  will  not  be copied and will be
29       deleted during the draining process.
30
31       If no specfic file server and file system is specified, or no limit  is
32       placed  on  the files to drain, then the involved active file system(s)
33       will have their status changed to RDONLY.  If any of the involved  file
34       systems are marked as DISABLED they will not have their status changed,
35       however an attempt will still be made to replicate the files from  them
36       and, if successful, delete the original.
37
38       Files  which  are  to be moved and belong to a space will be moved to a
39       different location (e.g. file system or disk server) but remain in  the
40       same  space. If there is no alternate location within the same space an
41       error will be reported for the file and it will not be drained.
42
43       Replicas of files with a lifetime will also have lifetime at  least  as
44       long  as  the  original. If this is not possible (for example available
45       pools have a maximum lifetime too short) then an error is given and the
46       file will not be drained.
47
48       This command requires ADMIN privilege.
49
50       pool_name
51              specifies  the  disk  pool  name  previously  defined using dpm-
52              addpool.
53
54       server specifies the host name of the disk server to be drained.
55
56       fs     specifies the mount point of the dedicated filesystem.
57
58       gid    specifies the comma separated list of gids to  which  the  files
59              must belong.
60
61       group  specifies  the comma separated list of groups to which the files
62              must belong.
63
64       size   specifies the minimum number of bytes to drain. The  number  may
65              be  post-fixed with 'k', 'M', 'G' or 'T' for kilobyte, Megabyte,
66              Gigabyte and Terabyte respectively.  Draining is halted once the
67              desired target has been reached or passed.  If size is not spec‐
68              ified or is given as zero  dpm-drain  will  drain  all  eligible
69              files.
70

EXAMPLE

72            setenv DPM_HOST dpmhost
73            setenv DPNS_HOST dpnshost
74
75            dpm-drain --poolname Permanent
76
77            dpm-drain --server lxb1921.cern.ch
78
79            dpm-drain --server lxb1921.cern.ch --fs /storage
80
81
82            dpm-drain --poolname Permanent --gid 105
83
84            dpm-drain --server lxb1921.cern.ch --group dteam
85
86            dpm-drain --server lxb1921.cern.ch --gid 105,104
87

EXIT STATUS

89       This  program  returns  0  if the operation was successful or >0 if the
90       operation failed.
91

SEE ALSO

93       dpm(1), dpm-qryconf(1)
94
95
96
97LCG          $Date: 2010-04-20 09:11:48 +0200 (Tue, 20 Apr 2010) $DPM-DRAIN(1)
Impressum