SRM-COPY-STATUS: BeStMan SRM-Client Tools User's Guide

• srm-copy-status requests to check the status of the previously submitted request with the request token that has been returned from the SRM.

Usage

• srm-copy-status <request_token> -requesttype <type> -serviceurl <SRM_endopint> [command line options]
• srm-copy-status -requesttoken <request_token> -requesttype <type> -serviceurl <SRM_endopint> [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
-debug	Specifies debugging output Default=false
-delegation <true¶false>	Force proxy delegation. When not provided, srm-copy-status makes no delegation by default, and automatically handles proxy delegation based on the source and/or target 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 an example below
-help	Show the help message
-log <path>	Specifies path to log file Default=./srmclient-event-date-random.log
-proxyfile <path>	Path to user grid proxy
-requesttoken <string>	Valid request token returned by the SRM server
-requesttype <get¶put¶copy¶bringonline>	Specifies the request type GET, PUT, COPY or BringOnline Default=copy
-quiet	Suppress output in the console. This option writes the output to the log file. Default=false
-renewproxy	Enables automatic proxy renewal upon expiration Works only when -usercert and -userkey are provided Prompts for the pass phrase Default=false
-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
-usercert <path>	Path to user grid certificate
-userkey <path>	Path to user grid certificate key

Notes

• srm-copy-status 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
    Target_URL
  

• Example 1 : PUT operation

  
    file:////tmp/my.source.data
    srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/mydir/mypath/myfile
  

• Example 2 : COPY operation from gsiftp to SRM

  
    gsiftp://gridftphost.lbl.gov//tmp/my.source.data
    srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/mydir/mypath/myfile
  

• Example 3 : COPY operation from SRM to SRM

  
    srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/mydir/my.source.file
    srm://bestman2.lbl.gov:8443/srm/v2/server?SFN=/mydir/my.target.file
  

• Example 4 : GET operation from SRM to local target directory (specified by command line option)

  
    srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/mydir/my.source.file
  

Examples

Check status of a request

• srm-copy-status <request_token> -requesttype <get ¶ put ¶ copy ¶ bringonline> -serviceurl <SRM_endopint>
• This command checks the request with the specified request token from the SRM server. [[/srmclients/samples/srm-copy-status-1.txt][Click here for the sample output.]]
• srm-copy-status TOKEN_GET_123 -requesttype get -serviceurl srm://bestman.lbl.gov:8443/srm/v2/server

Troubleshooting

• When the submitted request is large, the srm-copy-status may not fill all request information into the memory when receiving results from 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-copy-status 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