next up previous contents
Next: unregisterFile Up: Catalog Commands Previous: registerGUID   Contents

Command Line Tool

usage: edg-replica-manager registerGUID SURL GUID
Register a file that is already in a Grid-aware store with a GUID given to
the command. This is only necessary if replication could not be carried out
through replicateFile for some reason, like the data was shipped by tape.

 Arguments:
  SURL                  The SURL of the file to register.
  GUID                  The known GUID of this copy.

Register a file in the Replica Catalog with a known GUID. The use case for this command is the so-called truckFTP use case where the replication happens not over the network but through a tape delivered by FedEx (maybe this is cheaper). The remote site wants to register the received data using a known GUID and declare the data a valid replica of an existing file.

Semantics

The command takes two arguments: source file and GUID. The source file needs to be a qualified storage file name URI, following the same rule for SURLs as for registerFile above. The GUID needs to be known to the system already. Be careful, if the GUID corresponds to a wrong file in the remote catalog the catalog data will become inconsistent. If the SURL does not exist on the SE, the command fails.

Arguments

SURL
The file to be registered. It must be a valid SURL as described above.
GUID
The GUID to register the file with.

Options

None.

Return value

The call returns 0 on success and -1 on failure.

Errors

Some of the reasons for failure are:


next up previous contents
Next: unregisterFile Up: Catalog Commands Previous: registerGUID   Contents
2005-02-04