1DPM‐DRAIN(1) DPM Administrator Commands
2DPM‐DRAIN(1)
3[1mNAME[0m
7 dpm‐drain ‐ drain a component of the Light Weight Disk
8Pool Manager
9[1mSYNOPSIS[0m
11 [1mdpm‐drain ‐‐poolname [4m[22mpool_name[24m [ [1m‐‐serv‐
12er [4m[22mfs_server[24m ] [ [1m‐‐gid [4m[22mgids[24m ] [
13 [1m‐‐group [4m[22mgroups[24m ] [ [1m‐‐size
14[4m[22mamount_to_drain[24m ]
15 [1mdpm‐drain ‐‐server [4m[22mfs_server[24m [ [1m‐‐gid
17[4m[22mgids[24m ] [ [1m‐‐group [4m[22mgroups[24m ] [ [1m‐‐size[0m
18 [4mamount_to_drain[24m ]
19 [1mdpm‐drain ‐‐server [4m[22mfs_server[24m [1m‐‐fs
21[4m[22mfs_name[24m [ [1m‐‐gid [4m[22mgids[24m ] [ [1m‐‐group[0m
22 [4mgroups[24m ] [ [1m‐‐size [4m[22mamount_to_drain[24m ]
23 [1mdpm‐drain ‐‐help[0m
25[1mDESCRIPTION[0m
27 [1mdpm‐drain [22mdrains a component of the Light Weight
28Disk Pool Manager: a
29 filesystem, a disk server or a pool, optionally filtered
30by a list of
31 gids/groups. It replicates files which belong to the
32given list of
33 gids/groups (if specified) to another filesystem and re‐
34moves the origi‐
35 nal file. It gives an error message for files still
36pinned. The pool
37 name, the disk server name or the filesystem name can be
38specified.
39 [1mVolatile [22mfiles which have expired will not
41be copied and will be
42 [1mdeleted [22mduring the draining process.
43 If no specfic file server and file system is specified, or
45no limit is
46 placed on the files to drain, then the involved active
47file system(s)
48 will have their status changed to [1mRDONLY. [22mIf any
49of the involved file
50 systems are marked as [1mDISABLED [22mthey will not have
51their status changed,
52 however an attempt will still be made to replicate the
53files from them
54 and, if successful, delete the original.
55 Files which are to be moved and belong to a space will
57be moved to a
58 different location (e.g. file system or disk server) but
59remain in the
60 same space. If there is no alternate location within the
61same space an
62 error will be reported for the file and it will not be
63drained.
64 Replicas of files with a lifetime will also have lifetime
66at least as
67 long as the original. If this is not possible (for ex‐
68ample available
69 pools have a maximum lifetime too short) then an error is
70given and the
71 file will not be drained.
72 This command requires ADMIN privilege.
74 [4mpool_name[0m
76 specifies the disk pool name previously de‐
77fined using [1mdpm‐[0m
78 [1maddpool[22m.
79 [4mserver[24m specifies the host name of the disk server
81to be drained.
82 [4mfs[24m specifies the mount point of the dedicated
84filesystem.
85 [4mgid[24m specifies the comma separated list of gids
87to which the files
88 must belong.
89 [4mgroup[24m specifies the comma separated list of
91groups to which the files
92 must belong.
93 [4msize[24m specifies the minimum number of bytes to
95drain. The number may
96 be post‐fixed with ’k’, ’M’, ’G’ or ’T’ for kilo‐
97byte, Megabyte,
98 Gigabyte and Terabyte respectively. Draining is
99halted once the
100 desired target has been reached or passed. If size
101is not spec‐
102 ified or is given as zero dpm‐drain will drain
103all eligible
104 files.
105[1mEXAMPLE[0m
107 setenv DPM_HOST dpmhost
108 setenv DPNS_HOST dpnshost
109 dpm‐drain ‐‐poolname Permanent
111 dpm‐drain ‐‐server lxb1921.cern.ch
113 dpm‐drain ‐‐server lxb1921.cern.ch ‐‐fs /storage
115 dpm‐drain ‐‐poolname Permanent ‐‐gid 105
118 dpm‐drain ‐‐server lxb1921.cern.ch ‐‐group dteam
120 dpm‐drain ‐‐server lxb1921.cern.ch ‐‐gid 105,104
122[1mEXIT STATUS[0m
124 This program returns 0 if the operation was successful
125or >0 if the
126 operation failed.
127[1mSEE ALSO[0m
129 [1mdpm(1)[22m, [1mdpm‐qryconf(1)[0m
130LCG $Date$
134DPM‐DRAIN(1)
135