next up previous contents
Next: getAccessCost Up: Optimization Commands Previous: getBestFile   Contents

Command Line Tool

usage: edg-replica-manager getBestFile LFNorGUID [options]
Make a file available on local storage (or on the store specified by the -d
option).
 -d,--destination <host>      The destination SE. The file to be found is the
                              best source for a copy to this destination. If
                              it's omitted, the local SE is used.
 -n,--streams <#streams>      The number of parallel streams to use. Defaults
                              to 8.
 -p,--protocol <protocol>     The protocol to be used for an eventual
                              transfer. Defaults to gsiftp.
 -t,--turlProtocol <protocol> The protocol for the TURL that will be
                              returned. If not specified, the SURL will
                              be returned.

 Arguments:
  LFNorGUID             The LFN or GUID for which we request a copy to be
                        present at the destination specified by the -d
                        option (or the local SE if omitted)

Make the file available from local storage (or the storage specified by the destination option). The replica manager will find the best source to copy the file from, or will exit immediately if the file is already available on the given storage.

Semantics

First the LFN or GUID specified is resolved into a list of SURLs as described in the listReplicas command above. Then it is checked whether one of the replicas is actually on local storage (or the destination storage) in which case the command lists that file and exits.

If the file is not available, a listBestFile operation is carried out, with the given destination, and the best source for replication is found. Then that file is replicated to the destination just like described in the replicateFile command section.

Arguments

LFNorGUID
The LFN or GUID of the file for which we need a local replica (or on the specified destination).

Options

destination
The destination to replicate to. If not specified, the localSE is used as found through the information providers.
protocol
The protocol to be used. If it is omitted, the default protocol for the given SE is used.
streams
The number of parallel streams to be used for the copy. If omitted, the default is used for the given protocol.
turlProtocol
The protocol for the TURL that will be returned. If not specified, the SURL will be returned.

Return value

The call returns 0 on success and -1 on failure. It prints the SURL (or TURL) that can be used locally (or on the specified destination) upon success to stdout.

Errors

The call can fail for many reasons. Some of the reasons are:


next up previous contents
Next: getAccessCost Up: Optimization Commands Previous: getBestFile   Contents
2004-06-14