next up previous contents
Next: Commands Up: User Interface Previous: Differences to the previous   Contents

Command Line Interface

The command line interface to the EDG Replica Manager can be accessed via the edg-replica-manager command, or edg-rm for short. It takes a set of global options and then a command that has in turn options of its own.

The global options are listed if the command is given without any arguments:

usage: edg-replica-manager [options] command [options]
    --log-debug       enable debug-level logging
    --log-info        enable info-level logging
    --log-off         disable logging
 -h,--help            print help (if command is given, details on command)
 -i,--insecure        Connect in an insecure manner, i.e. not https.
    --config=<file>   read configuration from specified file
    --vo=<VO>         set Virtual Organization
 -v,--verbose         print additional information while executing

Note that currently the VO needs to be passed to the replica manager, e.g.
--vo=cms. The vo option will not be necessary once VOMS is available. Then
the VOMS certificate is parsed and the VO is extracted. If the --vo option
is still given, it is ignored and the VOMS VO is the one which is chosen.

The default configuration file will be read from $EDG_LOCATION/var/etc/edg-replica-manager/ edg-replica-manager.conf where $EDG_LOCATION is the installation location of Reptor (/opt/edg for a default installation).

The following commands (long or short forms) can be used in Reptor (the same description is printed using the -h option):

Management commands
copyAndRegisterFile cr Put a local file into Grid Storage and register it in the Catalog
bulkCopyAndRegister bcr Do multiple copyAndRegisters.
replicateFile rep Replicate an existing file to a certain Grid Storage, update Catalog
deleteFile del Delete a file from Storage and remove entry from Catalog
getTurl gt Get a TURL given a SURL and a protocol.
Catalog commands
registerFile rf Register a file in the catalog
registerGUID rg Register a file with a known GUID in the catalog
unregisterFile uf Unregister a file from the catalog
listReplicas lr List all replicas of a logical file name
listGUID lg List the GUID of a known LFN or SURL
addAlias add Add an LFN alias to an existing GUID
removeAlias ra Remove an alias to GUID mapping
printInfo pi Print all info service data to screen or to a
    file that can be reused by the static configuration
getVersion   Get the replica manager version
validate   Validate for correctness and normalize file names
Optimization commands
getBestFile gbf Replicate a file to the `nearest' Storage Element in the `cheapest' way
listBestFile lbf List the replica that has the smallest access cost
getAccessCost ac List access costs for all replicas
File transfer commands
copyFile cp Copy a file. Use this to copy a file to local store by specifying an LFN as the source and a local destination.
list ls List the contents of a directory on an SE (SRM or GridFTP)

In the following sections these commands are described in detail.


next up previous contents
Next: Commands Up: User Interface Previous: Differences to the previous   Contents
2004-06-14