Sphymove

From SRB

Contents

NAME

Sphymove - moves an SRB files/collections to a new resource

SYNOPSIS

Sphymove [-n replNum] [-c container] [-S targetResource] [-P newpathName] srbFile ...

Sphymove -b|r [-c container] [-S targetResource] [-s sourceResource] srbCollection ...

DESCRIPTION

Sphymove moves one or more SRB objects to the targetResource (if given). The old copy is deleted and the MCAT catalog is also updated.

It is implemented in 2 modes - the "file" mode or "collection" mode. The "file" mode which is the default mode, moves one or more individual files. The "bulk" mode, which is triggered with the -b or -r flags, is designed to move a large number of files (recursively) in one or more SRB collections efficiently.

In the "file" mode, if the -P option is used, the object will be stored in newpathName. Otherwise the object is stored in the default path for the targetResource.

The user should have at least 'write' access permission for srbFile. If the -n option is specified, the replNum copy will be moved. If the -c option is specified, the files will be moved into the specified container. The -c option overrides the -S option.

The recursive move of a collection can be done either in bulk (-b) or or non-bulk mode (-r).

In bulk mode, up to 200 files can be moved in a single (of many if necessary) move operation to improve efficient. It is designed to move a large number of small files. Also bulk phymove allows sysadmin to move other user's files.

But if the collection to be moved contains some large files (50 Mb and up), the non-bulk mode may be better because the move will be done using third party parallel I/O. If both the -b and -r options are specified, the -b option will take precedent.

It also accepts an optional -s option which specifies the Source Resource of the copy to be moved. If this option is specified, only SRB files stored in the given sourceResource will be moved. If the -s option is not used, all files that are not stored in the targetResource will be moved.

It is important to note that the -s option should be used whenever possible to eliminate unintended moves. Multiple sourceResources can be specified using the "|" character as seperator. e.g., "resource1|resource2|resource3".

It should be noted that if multiple sourceResources are specified, the move operation will use the host of the first resource on the list to launch the operation. Therefore, it is important to use the resource with the most files to be moved as the first sourceResource.


OPTIONS

-h
- Display command options
-b
- Specifies bulk move for moving large number of small files.
-r
- recurive non-bulk move for moving large files.
-n
replNum - An integer denoting the replica number of the object to be moved.
-P
newpathName - The physical path name of the new copy.
-S
targetResource - The target resource of the move. If not speci- fied, the default resource will be used as the target resource.
-c
container - The target container of the move. The container must already exist before the move. The option overrides the -S option.
-s
sourceResource - If specified, only files stored in this resource will be moved.


SEE ALSO

Smv, Sreplicate, Scp