BeStMan SRM-Client Tools User's Guide: Client commands and samples

For the details and samples of each command, follow the link on each client command.

Client commands involving discovery functions

  • srm-ping
    • srm-ping checks the SRM server. In response to the call, SRM server returns the SRM version number as well as other backend information.
  • srm-tranasferprotocols
    • srm-transferprotocols retrieves a list of file transfer protocols that the SRM server supports.
  • srm-util
    • srm-util handles discovery functions and permission related functions.

Client commands involving data transfer functions

  • srm-copy
    • srm-copy requests to copy files to and from SRM, between SRMs, between SRM and other storage repository.
  • srm-copy-status
    • srm-copy-status checks status of the request that has been submitted with srm-copy.

Client commands involving directory functions

  • srm-dir
    • srm-dir supports directory management functionality.
  • srm-ls
    • srm-ls supports directory or file browsing functionality and returns meta data of the directories or files.
  • srm-ls-status
    • srm-ls-status checks the status of the srm-ls request when request token was assigned because there are too many results or because it takes more time than SRM server could return the results immediately. Upon successful request, SRM server returns meta data of the directories or files.
  • srm-mkdir
    • srm-mkdir supports directory creation functionality in the namespace that SRM manages or has access to.
  • srm-mv
    • srm-mv supports move functionality in the namespace that SRM manages.
  • srm-rm
    • srm-rm removes an SURL of a file from the namespace that SRM manages or has access to.
  • srm-rmdir
    • srm-rmdir removes an SURL of a directory from the namespace that SRM manages or has access to.

Client commands involving permission functions

Client commands involving request management functions

  • srm-extendfilelifetime
    • srm-extendfilelifetime supports lifetime extension functionality on SURLs or pinned files.
  • srm-putdone
    • srm-putdone finalizes the put request on SURLs that has been submitted with srm-copy.
  • srm-release
    • srm-release releases pinned files from a request that has been submitted with srm-copy.
  • srm-req-abort
    • srm-req-abort submits abort on a request to the SRM server.
  • srm-req-abortfiles
    • srm-req-abortfiles submits abort on files of a request to the SRM server.
  • srm-req-resume
    • srm-req-resume submits resume on a suspended request to the SRM server.
  • srm-req-summary
    • srm-req-summary retrieves a summary information on a request from the SRM server.
  • srm-req-suspend *srm-req-suspend submits suspend on an active request to the SRM server.
  • srm-req-tokens
    • srm-req-tokens retrieves request tokens that belong to the user from the SRM server.
  • srm-request
    • srm-request handles request management functions.

Client commands involving space management functions

  • srm-space
    • srm-space handles space management functions.
  • srm-sp-change
    • srm-sp-change submits a request to change space for SURLs to a new space with the space token.
  • srm-sp-info
    • srm-sp-info retrieves an information about a space that is associated with a space token.
  • srm-sp-purge
    • srm-sp-purge removes all files from a space that is associated with a space token, unless a file is the last copy.
  • srm-sp-release
    • srm-sp-release release a space associated with a space token.
  • srm-sp-reserve
    • srm-sp-reserve requests to reserve a space with desired size.
  • srm-sp-reserve-status
    • srm-sp-reserve-status checks the status of the space reservation request that has been submitted with srm-sp-reserve, when SRM server takes time to handle the request and returns a request token.
  • srm-sp-tokens
    • srm-sp-tokens retrieves space tokens that belong to the user.
  • srm-sp-update
    • srm-sp-udpate updates space information such as size and lifetime.

Notes

  • srm client makes no proxy delegation by default, and automatically handles proxy delegation based on the source and target urls. A user can override the automatic handling by providing an option “-delegation” (or “-delegation true”) to force the delegation, and “-delegation false” to force no delegation. “-debug” option would show how the delegation is done on the output.
  • When a large request is submitted, the srm client may not fill all request information into the memory before submitting to the server. It is mostlikely because the memory size of the java virtual machine. In such case, you can increase the size of the virtual machine in srm client by -Xmx###M, where # is the amount of memory which you want to allocate in megabytes. E.g. java –Xmx512M
  • For memory conscious jobs, “-lite” option is provided to use less memory to handle the user request. The option the passes -Xms32M to the virtual machine.


You are here:   Software/SRMClients/BeStManClientsGuide/CommandSamples
Last Updated r2 on 2010-08-24 21:12:06 by Asim