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.