lcg-rep(1) - Linux man page

Name

lcg-rep - copy a file from one Storage Element to another Storage

Element and registers it in the LRC

Synopsis

lcg-rep [ --config config_file ] [ -d dest_file | dest_host ] [ -h,--help ] [ -D,--defaultsetype defaulttype ] [ -T,--srcsetype srctype ] [ -U,--dstsetype dsttype ] [ -P relative_path ] [ -nnbstreams ] [ -s,--sst src_spacetokendesc ] [ -S,-dst dest_spacetokendesc ] [ --connect-timeout conntimeout ] [ --sendreceive-timeout sndtimeout ] [ --bdii-timeoutbdiitimeout ] [ --srm-timeout srmtimeout ] [ --vo virtual_organization ] [ --checksum-typecksmtype ] [ --checksum ] [ -b,--nobdii ] [ -v,--verbose ] [ --version ] [ --src-protocolsprotocol_list ] [ --dst-protocols protocol_list ] src_file

Description

lcg-rep copies a file from one Storage Element to another Storage Element and registers it in the LRC or the LFC. If you specify a given command line option multiple times, the command takes into account only the very last one so that in a script, you can override a particular option in a pre-set option set (like gcc does).

src_file: specifies the source file name: the protocol can be LFN, GUID or SURL. An SURL scheme can be sfn: for a classical SE or srm:.
dest_file: specifies the destination. It can be the Storage Element fully qualified hostname or an SURL. In the latter case, the scheme can be sfn: for a classical SE or srm:. If only the fully qualified hostname is given, a filename is generated in the same format as with the Replica Manager.
relative_path: specifies the path relative to the SARoot for the given VO.
nbstreams: specifies the number of parallel streams (default 1).
defaulttype: specifies the default SE type you want to use. Possible values are none, se, srmv1, srmv2, for respectively no default type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will use another type.
srctype: specifies the SE type you want to use for the source file. Possible values are none, se, srmv1, srmv2, for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will fail.
dsttype: specifies the SE type you want to use for the destination file. Possible values are none, se, srmv1, srmv2, for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will fail.
src_spacetokendesc: specifies the space token to use with src_file
dest_spacetokendesc: specifies the space token to use with dest_file
conntimeout: Sets the connect timeout, used when connecting to a remote host. The connection will be aborted if the remote host doesn't reply after conntimeout seconds. Default: 60 seconds.
sndtimeout: Sets the send/receive data timeout, used when transferring data to/from a remote host. The connection will be aborted if no data is transfered after sndtimeout seconds. Default: 0 (blocking).
bdiitimeout: Sets the BDII timeout, used when searching information into BDII. The connection will be aborted if the search is longer than bdiitimeout seconds. Default: 60 seconds.
srmtimeout: Sets the SRM timeout, used when doing an asynchronous SRM request. The request will be aborted if it is still queued after srmtimeout seconds. Default: 3600 seconds (1 hour).
vo: specifies the Virtual Organization the user belongs to. If it is not specified, the environment variable LCG_GFAL_VO will be used.
conf_file: This argument is currently ignored.
cksmtype: is the checksum type (algorithm) to use. Possible values (case insensitive) are:
NONE: No checksum verification
CRC32: CRC32 algorithm will be used
ADLER32: Adler32 algorithm will be used
MD5: MD5 algorithm will be used
SHA1

SHA-1 algorithm will be used

protocol_list: A comma-separated list of protocols (for example protocol1,protocol2 )
--checksum: If this flag is present, verification of data integrity between source and destination files will be dine using default checksum algorithm (Adler32). In case of failure, the destination won't be removed, but an error message will be printed.
-b,--nobdii: If this flag is present, it means that you don't want to make BDII calls to get SE type. So, you must provide the type of the SE for srm: arguments, and full endpoint in SURLs. For SE type, defaulttype can be used (it will be used for both source and destination).
-v,--verbose: Verbose mode. You can specify it twice for extra verbose mode.
--src-protocols: The ordered list of transfer protocols to help TURL construction. The list is passed to the SE, it should pick up an appropriate one and construct source TURL-s according to it. Ignored if the source file does not follow the SURL scheme.
--dst-protocols: The ordered list of transfer protocols to help TURL construction. The list is passed to the SE, it should pick up an appropriate one and construct destination TURL-s according to it. Ignored if the destination file does not follow the SURL scheme.

Note

The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless --nobdii option is used. To use the RLS as catalog instead of the LFC, the environment variable LCG_CATALOG_TYPE must explicitely be set to "edg". By default, it is set to "lfc".

If no no destination SE is specified, we use the environment variable VO_<VO>_DEFAULT_SE, which is normally set on the Worker Node.

Example

    lcg-rep --vo dteam -d lxshare0236.cern.ch \
        srm://lxshare0282.cern.ch//pnfs/cern.ch/data/dteam/testjpb16

Exit Status

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

Referenced By

lcg-bringonline(1), lcg-get-checksum(1)