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