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