SRM-EXTENDFILELIFETIME: BeStMan SRM-Client Tools User's Guide
- srm-extendfilelifetime requests to extend lifetime of existing SURLs of volatile and durable file storage types or lifetime of pinned files (TURLs of the results of srmPrepareToGet, srmPrepareToPut or srmBringOnline).
Usage
- srm-extendlifetime <source_url> [command line options]
- srm-extendlifetime -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 and automatically handles proxy delegation based on the source 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
|
| -help |
|
| -lifetime <int> |
- File (SURL) lifetime in seconds
|
| -log <path> |
- Specifies path to log file
- Default=./srmclient-event-date-random.log
|
| -pinlifetime <int> |
- Pin lifetime in seconds to extend.
- -requesttoken must be specified.
|
| -proxyfile <path> |
|
| -quiet |
- Suppress output in the console.
- This option writes the output to the log file.
- Default=false
|
| -requesttoken <request_token> |
- Specifies a request token
|
| -s <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 <string> |
- Specifies space token
- Enables extension of files lifetime in the space that is associated with the space token.
|
| -usercert <path> |
- Path to user grid certificate
|
| -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
srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/mydir/mypath/myfile
Examples
Extend file (SURL) lifetime
- srm-extendfilelifetime srm://host:port/wsept?SFN=/target_filepath -lifetime seconds
- This command requests to extend file lifetime on the specified SURL. Click here for the sample output.
- srm-extendfilelifetime srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -lifetime 600
Extend pin lifetime of a file in a request
- srm-extendfilelifetime srm://host:port/wsept?SFN=/source_filepath -pinlifetime seconds -requesttoken token
- This command requests to extend pin lifetime of a file in the request. Click here for the sample output.
- srm-extendfilelifetime srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -pinlifetime 600 -requesttoken TOKEN_123456
Extend file lifetime in a space
- srm-extendfilelifetime srm://host:port/wsept?SFN=/source_filepath -lifetime seconds –spacetoken token
- This command requests to extend file lifetime in a space. Click here for the sample output.
- srm-extendfilelifetime srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -lifetime 600 -spacetoken STOKEN_12345
Troubleshooting
- When a large request is submitted, the srm-extendfilelifetime 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-extendfilelifetime 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
