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

Command Line Tool

edg-rm -h unregisterFile:

usage: edg-replica-manager unregisterFile GUID SURL
Unregister a file from the catalog.

 Arguments:
  GUID                  The GUID to unregister
  SURL                  The matching SURL to unregister

Unregister a file from the Replica Location Service that is stored on a Storage Element. It takes two arguments: the GUID and SURL to which the (GUID, SURL) mapping should be removed.

Note: in order to remove/unregister an LFN, use the command removeAlias.

Semantics

This command removes a replica of a file from `grid awareness'. The file stored at the SE and identified with the SURL will not be removed (this is achieved using deleteFile). If the SURL does not actually exist on the SE, the command will be successful anyway. If the SURL specified is the only instance (replica) of the given file, the GUID will be removed as well, otherwise only the SURL is removed from the Catalog.

Note: Since LFNs (aliases) are treated like symbolic links in the Replica Metadata Catalog, if the last GUID is deleted from the RLS, the corresponding LFNs are not deleted from the Replica Metadata Catalog which results in ``dangling LFNs'' (similar to ``dangling symbolic links'').

Arguments

GUID
The GUID to unregister for a given SURL.
SURL
The file to be unregistered. It must be a valid Storage File Name, i.e. the host part of the given URI needs to be a recognized Storage Element, as described above.

Options

None.

Return value

The call returns 0 on success and -1 on failure and prints the GUID with which this file was registered to stdout.

Errors

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


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