1XPROOFD(1) General Commands Manual XPROOFD(1)
2
6 xproofd - PROOF (The Parallel ROOT Facility) xrootd version
7
9 xproofd [ -c cfn ] [ -d ] [ -l fnc ] [ -n name ] [ -p port ] [ -P prot
10 ] [ prot_options ]
11
13 Using PROOF (The Parallel ROOT Facility) one can analyze trees in par‐
14 allel on a cluster of computers. The PROOF system consists of the
15 xproofd(1) from-end program which is started via inetd(8).
16 xproofd takes care of user authentication and overlays itself then with
18 the desired version of the proofserv(1) executable.
19 interactive module root(1), except that it reads its commands from a
21 socket instead of from the terminal.
22 Since it is a remote server it will not do graphics and therefore is
24 not linked with any graphics libraries (Motif, X11, etc.).
25
28 Since you need to handle sensitive system files, you need to have root
29 (the user, not the program!) privileges. Also, it's recommended that
30 you read the appropriate man(1) pages first. These are inetd(8) (the
31 internet daemon), sysklogd(8) and syslog(3) (the system logger daemon),
32 and init(8) (the SYSV process control initializer).
33 In other words:
35 Be very VERY careful when installing xproofd
36 There, I said it. And of course, no warranties what so ever.
37 1 Make sure every node has ROOT installed. We'll assume you
39 installed the ROOT applications in <bindir> (e.g. /usr/bin) and
40 the PROOF configuration files in files in <xproofdir>/etc (e.g.
41 /usr/share/root/etc).
42 2 The TCP port 1094 was allocated by IANA, ( www.iana.org ), to
45 xrootd, so add to /etc/services the lines:
46 xproofd 1093/tcp
48 xrootd 1094/tcp
49 3 On each node, add to /etc/inetd.conf the lines:
53 xproofd stream tcp nowait root <bindir>/xproofd xproofd <xproofdir>/proof
55 xrootd stream tcp nowait root <bindir>/xrootd xrootd -i
56 You can substitute the <xproofdir> with any directory that holds
58 your PROOF configuration, for example /etc/root/proof. However,
59 it should be shared among all nodes in the cluster.
60 4 Restart inetd or force it to re-read the config file:
63 kill -1 <inetd pid>
65 If you use SYSV [22minit(8) scripts, you can probably just do
67 /etc/init.d/inetd restart
69 or whatever is appropriate for your system.
71 5 On the master node, add to /etc/syslog.conf the line:
74 local5,local6.debug <xproofdir>/log/proof.log
76 and all slave nodes:
78 local5,local6.debug @<master hostname>
80 where <master hostname> is domain name of the master node. All
82 PROOF syslog messages will be collected on the master node.
83 Just make one node in the cluster the master, all others are
84 slaves.
85 6 On all nodes, change the below lines in /etc/syslog.conf,
88 *.info;mail.none;news.none;authpriv.none /var/log/messages
90 to:
92 *.info;local5,local6,mail.none;news.none;authpriv.none /var/log/messages
94 7 Create an empty <xproofdir>/log/proof.log:
98 echo "" > <xproofdir>/log/proof.log
100 8 Restart syslogd or force it to re-read the config file:
104 kill -1 <syslogd pid>.
106 If you use SYSV [22minit(8) scripts, you can probably just do
108 /etc/init.d/sysklogd restart
110 or whatever is appropriate for your system.
112 9 Edit <xproofdir>/etc/proof.conf to reflect your cluster configu‐
115 ration. See the example proof.conf file for more information.
116 If you installed ROOT using some precompiled package (for example a
118 Redhat Linux or a Debian GNU/Linux package), steps 2 to 4 may already
119 be done for you.
120 If you're running Linux, Steps 5 to 7 can be somewhat automated using
122 the script proof-facility in <xproofdir> of your distribution. This
123 script uses syslog-facility(1), from the Linux [22msyslog(1) distribution,
124 and may run on other platforms as well - but no warranties mind you!
125 Step 9 is completely up to the user.
127
129 That's it. To test PROOF try the following:
130 root [1] gROOT->Proof("<master hostname>")
132 root [2] gPROOF->Print()
133 <shows information on the master and all active slave servers>
134 root [3] .q
135
138 <xproofdir>
139 The location of your PROOF data. In binary packages, like for
140 Redhat LinuxI or Debian GNU/Linux, this will probably be
141 /usr/share/root/proof. If you got a binary [22mtar(1)-ball from the
142 ROOT website, or a build it yourself without the static paths
143 option, then this directory could be ROOTSYS/proof. However, you
144 may set it to something else when starting your server.
145 <xproofdir>/etc
147 This directory holds all the configuration files for your clus‐
148 ter(s).
149 <xproofdir>/etc/<cluster>.conf
151 This is the cluster named <cluster> configuration file. See
152 <xproofdir>/etc/<cluster>.conf.sample for an example.
153 <xproofdir>/etc/motd
155 This is Message-Of-The-Day file. See <xproofdir>/etc/motd.sample
156 for an example.
157 <xproofdir>/etc/noproof
159 If this file is present, all PROOF services will be disabled.
160 See <xproofdir>/etc/noproof.sample for an example.
161 <xproofdir>/etc/proof.conf
163 This is the PROOF configuration file. See
164 <xproofdir>/etc/proof.conf.sample for an example.
165 ~/.rootnetrc.conf
167 Configuration file for network access. Here you specify login
168 names and pass word, so it MUST be read/write-able only by the
169 user. See <xproofdir>/etc/rootnetrc.conf.sample for an example.
170 <xproofdir>/log
172 This directory holds the log files from the master and slaves.
173 <xproofdir>/log/proof.log [22mSyslog(1) log file for PROOF.
174
176 proofserv(1) , root(1) , xrootd(1)
177 More information can be found at the ROOT website: http://root.cern.ch
179
181 The ROOT team (see web page above):
182 Rene Brun and Fons Rademakers
183
185 This library is free software; you can redistribute it and/or modify it
186 under the terms of the GNU Lesser General Public License as published
187 by the Free Software Foundation; either version 2.1 of the License, or
188 (at your option) any later version.
189 This library is distributed in the hope that it will be useful, but
191 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
192 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
193 General Public License for more details.
194 You should have received a copy of the GNU Lesser General Public
196 License along with this library; if not, write to the Free Software
197 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
198 USA
199
201 This manual page was written by Christian Holm Christensen
202 <cholm@nbi.dk>, for the Debian GNU/Linux system (but may be used by
203 others).
204ROOT Version 3 XPROOFD(1)