SRM-LS: BeStMan SRM-Client Tools User's Guide

• srm-ls handles directory or file browsing and retrieves information.

Usage

• srm-ls <source_url> [command line options]
• srm-ls -f <input_file> [command line options]

Options

• Command line options take priority from the options from conf file.
• Options in the following table are in alphabetical order

-authid <string>	Authorization ID to be used in SRM for the request
-conf <path>	Path to the configuration file. Command line options will override the options from conf file
-connectiontimeout <int>	enforces http connection timeout in the given seconds. Default=1800
-count <int>	Specifies count for LS in case there are too many listing Default=0
-debug	Specifies debugging output Default=false
-delegation <true¶false>	Force proxy delegation. When not provided, srm-ls automatically handles proxy delegation based on the source URLs. When –delegation is provided, it forces the user choice.
-f <path>	Path to the xml input file containing the source url, target url information for requests with more than one file Refer to the format and examples below
-filestoragetype <p ¶ d ¶ v>	Indicates filestorage type p - Permanent, d - Durable, v - Volatile No default
-fulldetailed	Specify to request detailed information on the source url Default=false
-help	Show the help message
-log <path>	Specifies path to log file Default=./srmclient-event-date-random.log
-numlevels <int>	Specifies the number of levels of recursiveness in LS Default=1
-offset <int>	Specifies offset for LS in case there are too many listing Default=0
-proxyfile <path>	Path to user grid proxy
-quiet	Suppress output in the console. This option writes the output to the log file. Default=false
-recursive	Specifies recursive listing with -ls option Default=false
-renewproxy	Enables automatic proxy renewal upon expiration Works only when -usercert and -userkey are provided Prompts for the pass phrase Default=false
-report <path>	Specifies path to full report output.
-s <source_url>	Source URL
-serviceurl <endpoint>	Full web service endpoint Required when source url or target url does not contain web service endpoint information
-sethttptimeout <int>	set client-side http connection timeout in the given seconds. Default=600
-statusmaxtime <int>	Max time before status checks get timed out, in seconds Default=600
-statuswaittime <int>	Wait time delay between status check, in seconds Default=30
-storageinfo <string>	extra storage access information For BeStMan supporting MSS, a formatted input separated by comma is used with following keywords when necessary: for:<source¶target¶sourcetarget>,login:<string>,passwd:<string>,projectid:<string>,readpasswd:<string>,writepasswd<string>
-submitonly	Enables request submission only When provided, srm-ls exits after the request submission. Otherwise, it continues checking status until it is timed out or gets return status. Default=false
-usercert <path>	Path to user grid certificate
-userkey <path>	Path to user grid certificate key
-xmlreport <path>	Specifies path to short output report in XML format.

Notes

• srm client makes no proxy delegation by default, and automatically handles proxy delegation based on the source 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.

Input file format

  
   Source_URL
  

• Example 1 : LS operation

  
    srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/mydir/mypath/myfile
  

Examples

Browse a file in SRM server

• srm-ls srm://host:port/wsept?SFN=/source_filepath
• This command retrieves the file info from SRM or from the file system that SRM can access to. Click here for the sample output.
• srm-ls srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data

Browsing a directory in SRM server

• srm-ls srm://host:port /wsept?SFN=/source_dirpath
• This command retrieves the directory info from SRM or from the file system that SRM can access to. Click here for the sample output.
• srm-ls srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/dir
• srm-ls srm://host:port /wsept?SFN=/source_dirpath -recursive
• This command retrieves the directory info recursively from SRM or from the file system that SRM can access to. Click here for the sample output.
• srm-ls srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/dir -recursive

Browsing a file in gridftp server

• srm-ls gsiftp://host:port//target_filepath
• This command retrieves the file information from the gridftp server. Click here for the sample output.
• srm-ls gsiftp://gridftphost.lbl.gov//data/path/test.data

Browsing a directory in gridftp server

• srm-ls gsiftp://host:port//source_dirpath
• This command retrieves the directory info from the gridftp server. Click here for the sample output.
• srm-ls gsiftp://gridftphost.lbl.gov//data/path/source.dir
• srm-ls gsiftp://host:port//source_dirpath -recursive
• This command retrieves the directory info recursively from the gridftp server. Click here for the sample output.
• srm-ls gsiftp://gridftphost.lbl.gov//data/path/source.dir -recursive

Browsing a local file

• srm-ls file:////target_filepath
• This command retrieves the file information from the local file system. Click here for the sample output.
• srm-ls file:////data/path/test.data

Browsing a local directory

• srm-ls file:////source_dirpath
• This command retrieves the directory info from the local file system. Click here for the sample output.
• srm-ls file:////data/path/source.dir
• srm-ls file:////source_dirpath -recursive
• This command retrieves the directory info recursively from the local file system. Click here for the sample output.
• srm-ls file:////data/path/source.dir -recursive

Troubleshooting

• When a large LS request is submitted or expected, the srm-ls may not fill all request or status information into the memory. 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-ls 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.

See Also

• srm-ls-status, srm-dir
• BeStMan SRM-Client Tools User's Guide: Client commands and samples