SRM-SP-CHANGE: BeStMan SRM-Client Tools User's Guide

• srm-sp-change requests to change the space property of files to another space property by specifying target space tokens. All files specified by SURLs will have a new space token. SURLs will not be changed. New space token may be acquired from srm-sp-reserve. There is no default behavior when target space token is not provided, and in such case, the request will be failed.

Usage

• srm-sp-change <service_url> -spacetoken <space_token> -s <source_url> [command line options]
• srm-sp-change <service_url> -spacetoken <space_token> -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
-debug	Specifies debugging output Default=false
-delegation <true¦false>	Force proxy delegation. When not provided, srm client makes no delegation by default. 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 information for requests with more than one file Refer to the format and examples 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
-quiet	Suppress output in the console. This option writes the output to the log file. Default=false
-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
-spacetoken <space_token>	Specifies target space token
-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>
-usercert <path>	Path to user grid certificate
-userkey <path>	Path to user grid certificate key

Notes

• srm client makes no proxy delegation by default. 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
  

Examples

Change space for a file

• srm-sp-change srm://host:port/wsept -spacetoken <space_token> -s srm://host:port/wsept?SFN=/source_filepath
• This command requests to change space for a file to space that is specified with the space token. [[/srmclients/samples/srm-sp-change-11.txt][Click here for the sample output.]]
• srm-sp-change srm://bestman.lbl.gov:8443/srm/v2/server -spacetoken SPACE_TOKEN_V12345 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.file

Troubleshooting

• None reported

See Also

• srm-copy, srm-space
• BeStMan SRM-Client Tools User's Guide: Client commands and samples