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)

Info