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

• srm-request manages request related operations, such as abort, extending lifetimes, suspend and resume.

Usage

• srm-request <service_url> [command line options]
• srm-request <service_url> -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

-abortfiles <request_token>	Specifies a request to abort files in the request Used with -s or -f to specify SURLs
-abortrequest <request_token>	Specifies a request to abort
-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
-debug	Specifies debugging output Default=false
-delegation <true¶false>	Force proxy delegation. When not provided, srm client makes no delegation by default, and automatically handles proxy delegation based on the source and target URLs. When -delegation is provided, it overrides the automatic handling and 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
-getrequesttoken	Retrieves request tokens that belong to the client
-help	Show the help message
-lifetime <int>	File (SURL) lifetime in seconds Used with –s or –f to specify SURLs
-log <path>	Specifies path to log file Default=./srmclient-event-date-random.log
-pinlifetime <int>	File pin lifetime in seconds Mostly on TURLs
-proxyfile <path>	Path to user grid proxy
-quiet	Suppress output in the console. This option writes the output to the log file. Default=false
-requestsummary <request_token>	Specifies a request to retrieve request summary
-requesttoken <request_token>	Specifies a request token
-resume <request_token>	Specifies a previously suspended request to resume
-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
-suspend <request_token>	Specifies a request to suspend
-usercert <path>	Path to user grid certificate
-userdesc <string>	Specifies user request description
-userkey <path>	Path to user grid certificate key

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.

Input file format

  
    Source_URL
  

• Example 1

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

Examples

Abort a request

• srm-request srm://host:port/wsept -abortrequest <request_token>
• This command requests to abort a request that is specified with the request token. [[/srmclients/samples/srm-request-11.txt][Click here for the sample output.]]
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -abortrequest TOKEN_GET_12345

Abort a file in a request

• srm-request srm://host:port/wsept -abortfiles <request_token> -s srm://host:port/wsept?SFN=/my_file_path
• This command requests to abort a file in the re2uest that is specified with the request token. [[/srmclients/samples/srm-request-21.txt][Click here for the sample output.]]
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -abortfiles TOKEN_GET_12345 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.file

Extend lifetime of a file in a request

• srm-request srm://host:port/wsept -lifetime <seconds> -s srm://host:port/wsept?SFN=/source_filepath
• This command requests to extend SURL lifetime. Click here for the sample output.
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -lifetime 3600 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data
• srm-request -lifetime 3600 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data

Extend pin lifetime of a file in a request

• srm-request srm://host:port/wsept -extlifetime <request_token> -pinlifetime <seconds> -s srm://host:port/wsept?SFN=/source_filepath
• This command requests to extend pin lifetime of a file in a request. Click here for the sample output.
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -extlifetime TOKEN_GET_12345 -pinlifetime 3600 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data
• srm-request -extlifetime TOKEN_GET_12345 -pinlifetime 3600 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data

Retrieve request summary

• srm-request srm://host:port/wsept -requestsummary <request_token>
• This command requests to retrieve the request summary for the request that is specified with the request token. [[/srmclients/samples/srm-request-51.txt][Click here for the sample output.]]
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -requestsummary TOKEN_GET_12345

Retrieve request tokens

• srm-request srm://host:port/wsept -getrequesttoken
• This command requests to retrieve the request tokens that belong to the client. [[/srmclients/samples/srm-request-61.txt][Click here for the sample output.]]
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -getrequesttoken
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -getrequesttoken -userdesc “my request token”

Suspend a request

• srm-request srm://host:port/wsept -suspend <request_token>
• This command requests to suspend the request. Click here for the sample output.
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -suspend TOKEN_GET_12345

Resume a request

• srm-request srm://host:port/wsept -resume <request_token>
• This command requests to resume a previously suspended request. Click here for the sample output.
• srm-request srm://bestman.lbl.gov:8443/srm/v2/server -resume TOKEN_GET_12345

Troubleshooting

• When a large request is submitted, the srm-request 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-request 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-copy, srm-request
• BeStMan SRM-Client Tools User's Guide: Client commands and samples