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

NAME

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

SYNOPSIS

       dpm-drain --poolname pool_name [ --server fs_server ] [ --gid gids ] [ --group groups ] [ --size amount_to_drain ]

       dpm-drain --server fs_server [ --gid gids ] [ --group groups ] [ --size amount_to_drain ]

       dpm-drain --server fs_server --fs fs_name [ --gid gids ] [ --group groups ] [ --size amount_to_drain ]

       dpm-drain --help

DESCRIPTION

       dpm-drain drains 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.

       Volatile files which have expired will not be copied and will be deleted during 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 sys-
       tem(s) will have their status changed to RDONLY.  If any of the involved file systems are marked as DISABLED they will not have their  sta-
       tus 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.

       pool_name
	      specifies the disk pool name previously defined using dpm-addpool.

       server specifies the host name of the disk server to be drained.

       fs     specifies the mount point of the dedicated filesystem.

       gid    specifies the comma separated list of gids to which the files must belong.

       group  specifies the comma separated list of groups to which the files must belong.

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

EXAMPLE

	    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

EXIT STATUS

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

SEE ALSO

       dpm(1), dpm-qryconf(1)

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