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

Command Line Tool

usage: edg-replica-manager listBestFile LFNorGUID [options]
Return the SURL that has the smallest access cost from the local store (or
from 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.
 -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 want to list the
                        'best' SURL as seen from the destination specified
                        by the -d option (or the local SE if omitted)

List the best replica, i.e. the replica which can be transferred to the local SE (or the SE specified by -d) in the fastest time.

Semantics

First the LFN or GUID specified is resolved into a list of SURLs as described in the listReplicas command above. Then the Replica Optimization Service is contacted with the given list of SURLs, and the specified destination host (or the local SE host if none was specified). The ROS will return the SURL that has the smallest access cost from the given host at this point in time.

Arguments

LFNorGUID
The LFN or GUID of the file of which the `best' replica should be found.

Options

destination
The host that is the point of reference for calculating the network and storage access cost. If not specified, the localSE is used as found through the information providers.
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 'best' SURL on success to stdout.

Errors

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


next up previous contents
Next: getBestFile Up: Optimization Commands Previous: listBestFile   Contents
2005-02-04