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

srm-util requests to manage permissions or to retrieve supported transfer protocols.

Usage

• srm-util source_url [command line options]
• srm-util -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
-checkpermission	Specifies to check the permission info
-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 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 an example
-getpermission	Specifies to retrieve the permission info
-grouppermissions <group:mode>	Specifies group permission mode Mode is specified by none¶x¶w¶wx¶r¶rx¶rw¶rwx Comma separated list E.g. group1:rw,group2:r,group3:r
-help	Show the help message
-log <path>	Specifies path to log file Default=./srmclient-event-date-random.log
-otherpermission <none¶x¶w¶wx¶r¶rx¶rw¶rwx>	Specifies other permission mode
-ownerpermission <none¶x¶w¶wx¶r¶rx¶rw¶rwx>	Specifies owner permission mode
-permissiontype <add¶remove¶change>	Specifies permission type to request
-ping	Retrieves ping info
-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
-setpermission	Specifies to set the permissions on SURLs. Used with -permissiontype and -ownerpermission, userpermissions, -grouppermissions or -otherpermission.
-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>
-transferprotocols	Retrieves the list of supported transfer protocols
-usercert <path>	Path to user grid certificate
-userkey <path>	Path to user grid certificate key
-userpermission <user:mode>	Specifies user permission mode Mode is specified by none¶x¶w¶wx¶r¶rx¶rw¶rwx Comma separated list e.g. user1:rw,user2:r,user3:r

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

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

Examples

Ping an SRM server

• srm-util srm://host:port/wsept -ping
• This command pings the SRM server. Click here for the sample output.
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server -ping

Retrieve a list of supported file transfer protocols

• srm-util srm://host:port/wsept -transferprotocols
• This command retrieves a list of file transfer protocols that SRM supports. Click here for the sample output.
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server -transferprotocols

Retrieve permission information on a file

• srm-util -s srm://host:port/wsept?SFN=/source_filepath -getpermission
• This command retrieves the permission information on the SURL. Click here for the sample output.
• srm-util -s srm://bestman.lbl.gov:8443/srm/v2/server\?SFN=/srmcache/guest/test.data -getpermission

Set permission information on a file

• srm-util -s srm://host:port/wsept?SFN=/source_filepath -setpermission -permissiontype <type> -userpermissions <user:mode> -grouppermissions <group:mode> -otherpermission <mode>
• This command requests to set the permission information on the SURL. Click here for the sample output.
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -setpermission -permissiontype add -userpermissions “user1:rw,user2:r,user3:r”
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -setpermission -permissiontype add -grouppermissions “group1:rw,group2:r”
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -setpermission -permissiontype add-otherpermission r
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -setpermission -permissiontype add -userpermissions “user1:rw,user2:r,user3:r” -grouppermissions “group1:rw,group2:r” -otherpermission r
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -setpermission -permissiontype change -userpermissions “user1:r” -grouppermissions “group1:r” -otherpermission none

Check permission information on a file

• srm-util -s srm://host:port/wsept?SFN=/source_filepath -checkpermission
• This command requests to check the permission information on the SURL for the client. Click here for the sample output.
• srm-util srm://bestman.lbl.gov:8443/srm/v2/server?SFN=/srmcache/guest/test.data -checkpermission

Troubleshooting

• None reported

See Also

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