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

• srm-space requests to manage spaces in SRM. Operations include reserving space, checking the space reservation request, updating space, releasing and purging space, and retrieving space information.

Usage

• srm-space service_url -reserve -size <total_size> -gsize <guaranteed_size> -lifetime <seconds> [command line options]
• srm-space service_url -release <space_token> [command line options]
• srm-space service_url -purge <space_token> [command line options]
• srm-space service_url -change <space_token> [command line options]
• srm-space service_url -update <space_token> -size <total_size> -gsize <guaranteed_size> -lifetime <seconds> -retentionpolicy <retention_policy> -accesslatency <access_latency> [command line options]
• srm-space service_url -extendlifetime <space_token> -lifetime <seconds> [command line options]
• srm-space service_url -getspacetoken [command line options]
• srm-space service_url -getspaceinfo <space_token> [command line options]

Options

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

-accesslatency <online¶nearline>	Specifies access latency Default=online
-authid <string>	Authorization ID to be used in SRM for the request
-change <space_token>	Requests to change spaces to the specified space for SURLs
-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 URLs. When -delegation is provided, it overrides the automatic handling and forces the user choice.
-extendlifetime <space_token>	requests to update the file lifetime for all files in the space specified by the space token Use with -lifetime
-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
-forcerelease	Requests to release files in a space Default=false
-getspaceinfo <space_token>	Retrieves the space info
-getspacetoken	Retrieves space tokens that belong to the client
-gsize <int>	Specifies the desired guaranteed space size in bytes
-help	Show the help message
-lifetime <int>	Specifies desired space lifetime in seconds
-log <path>	Specifies path to log file Default=./srmclient-event-date-random.log
-proxyfile <path>	Path to user grid proxy
-purge <space_token>	Requests to purge files from the space
-quiet	Suppress output in the console. This option writes the output to the log file. Default=false
-release <space_token>	Requests to release the space
-reserve	Requests to reserve a space and gets the space token when successful
-retentionpolicy <replica ¶ output ¶ custodial>	Specifies retention quality Default=replica
-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
-size <int>	Specifies the desired total space size in bytes
-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>
-update <space_token>	Requests to update the space
-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 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 : PURGE, CHANGE, EXTENDFILELIFETIME operation

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

Examples

Reserve a space

• srm-space srm://host:port/wsept -reserve -size <bytes> -gsize <bytes> -lifetime <seconds>
• This command requests to reserve a space in the SRM. Click here for the sample output.
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -reserve -size 50000000 -gsize 40000000 -lifetime 3600

Release a space

• srm-space srm://host:port/wsept -release <space_token>
• This command requests to release a previously reserved space and all files in the space that is specified with the space token, regardless of their file statuses. [[/srmclients/samples/srm-space-21.txt][Click here for the sample output.]]
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -release SPACE_TOKEN_V12345
• srm-space srm://host:port/wsept -release <space_token> -forcerelease
• This command requests to release a previously reserved space in the SRM that is specified with the space token, and their file statuses. [[/srmclients/samples/srm-space-22.txt][Click here for the sample output.]]
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -release SPACE_TOKEN_V12345 -forcerelease

Update a space

• srm-space srm://host:port/wsept -update <space_token> -size <bytes> -gsize <bytes> -lifetime <seconds>
• This command requests to update a previously reserved space in the SRM that is specified with the space token. [[/srmclients/samples/srm-space-31.txt][Click here for the sample output.]]
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -update SPACE_TOKEN_V12345 –size 90000000 -gsize 80000000 -lifetime 7200

Change space for a file

• srm-space srm://host:port/wsept -change <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-space-41.txt][Click here for the sample output.]]
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -change SPACE_TOKEN_V12345 -s srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.file

Purge a space

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

Retrieve space tokens

• srm-space srm://host:port/wsept -getspacetoken
• This command requests to retrieve all space tokens that belong to the client. [[/srmclients/samples/srm-space-61.txt][Click here for the sample output.]]
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -getspacetoken

Retrieve space information

• srm-space srm://host:port/wsept -getspaceinfo <space_token>
• This command requests to retrieve the space information that is specified by the space token. [[/srmclients/samples/srm-space-71.txt][Click here for the sample output.]]
• srm-space srm://bestman.lbl.gov:8443/srm/v2/server -getspaceinfo SPACE_TOKEN_V12345

Troubleshooting

• None reported

See Also

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