1xrootdfs(1) General Commands Manual xrootdfs(1)
2
6 xrootdfs - xrootd FUSE file system daemon
7
9 xrootdfs [options] parameters
10
13 The xrootdfs daemon provides a file system view of an xrootd cluster
14 using FUSE. Usage synopsis can be displayed by typing "xrootdfs -h".
15 Short documentation can be found in a README file in the src/XrdFfs
16 source directory.
17
20 Assuming the redirector is rdr:port
21 run from command line with debugging output
23 xrootdfs -d -o rdr=root://rdr:port//data,uid=daemon /mnt
24 use in /etc/fstab
26 xrootdfs /mnt fuse rdr=root://rdr:port//data,uid=daemon 1 2
27 use with autofs
29 1. add a line to /etc/auto.master
30 /- /etc/auto.fuse
31 2. create /etc/auto.fuse with the following one line
33 /mnt -fstype=fuse,uid=2,rdr=root://rdr\:port//data :xrootdfs.sh
34 3. create script /usr/bin/xrootdfs.sh (make sure +x bit is set)
36 #!/bin/sh
37 exec /usr/bin/xrootdfs $@ >/dev/null 2>&1
38
41 Documentation for all components associated with xrootdfs can be found
42 at http://xrootd.org/docs.html
43 xrootdfs allows users and administators to query and change the inter‐
45 nal parameters on the fly via the filesystem extended attributes
46 getfattr -n attribute_name /mount_point
48 setfattr -n attribute_name [ -v value ] /mount_point
49 attribute_name:
51 xroot.url: query the actual ROOT url of the file (this is an old
52 one)
53 xrootdfs.fs.nworkers: query or change the number of threads
54 working in parallel on operations such as stat(), un‐
55 link()/rmdir(), readdir(), statvfs(), etc.
56 xrootdfs.fs.dataserverlist: query or refresh the list of all
57 data servers known to this xrootdfs instance (or "kill -USR1
58 pid" to refresh)
59
62 By default, XrootdFS does not send individual user identity to the
63 Xrootd storage servers. So Xrootd storage thinks that all operations
64 from an XrootdFS instance come from the user that runs the XrootdFS in‐
65 stance. When the Xrootd "sss" security module (Simple Shared Security)
66 is enabled at both XrootdFS and Xrootd storage system, XrootdFS will
67 send individual user identity information to the Xrootd storage
68 servers. This info can be used along with the Xrootd ACL to control
69 file/directory access.
70 To use "sss" security module, both Xrootd data servers and XrootdFS
72 should be configured to use "sss" in a particular way, e.g. both sides
73 should use a key file that contains the same key generated by the
74 xrdsssadmin program in the following way:
75 xrdsssadmin -k my_key_name -u anybody -g usrgroup add keyfile
77 (change only "my_key_name" and "keyfile"). Please refer to environment
79 variable "XrdSecsssKT" in Xrootd "Authentication & Access Control Con‐
80 figuration Reference" for more information on the location of the key‐
81 file and its unix permission bits. That same document also describes
82 the Xrootd ACL DB file.
83 To enable "sss" with XrootdFS, use the sss=/keyfile option with
85 XrootdFS.
86 The following example shows how to use both unix and sss security mod‐
88 ules with the Xrootd data servers.
89 xrootd.seclib /usr/lib64/libXrdSec.so
91 sec.protocol /usr/lib64 sss -s /keyfile
92 sec.protocol /usr/lib64 unix
93 acc.authdb /your_xrootd_ACL_auth_db_file
94 acc.authrefresh 300
95 ofs.authorize
96
99 Errors yield an error message and a non-zero exit status. The program
100 never exits upon success. Use the umount command to terminate the pro‐
101 gram.
102 Additional logging information can be found in syslog (/var/log/mes‐
104 sages)
105
107 License terms can be displayed by typing "xrootd -H".
108
110 The xrootdfs daemon is supported by the xrootd collaboration. Contact
111 information can be found at
112 http://xrootd.org/contact.html
113 v5.4.3 xrootdfs(1)