"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "root/README/README.PROOF" of archive root_v5.20.00.win32gcc.tar.gz:


As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
    1 Installing and using the Parallel ROOT Facility -- PROOF
    2 ========================================================
    3 
    4 PROOF allows the parallel execution of ROOT scripts and the
    5 parallel analysis of ROOT trees on a heterogeneous cluster.
    6 
    7 To install and use PROOF on a cluster do the following:
    8 
    9 0) Make sure each node in the cluster has /usr/local/root
   10    or /opt/root. This can be directly an un-tared binary
   11    distribution of ROOT or a link to a centrally installed
   12    copy of ROOT.
   13 
   14 
   15 1) Add to /etc/services the lines:
   16 
   17    proofd          1093/tcp
   18    rootd           1094/tcp
   19 
   20 
   21 2) Add to /etc/inetd.conf the lines:
   22 
   23    proofd stream tcp nowait root /usr/local/root/bin/proofd proofd -i /usr/local/root
   24    rootd stream tcp nowait root /usr/local/root/bin/rootd rootd -i
   25 
   26    Or when using xinetd add the following two files to /etc/xinetd.d:
   27 
   28    # file name: rootd
   29    # default: on
   30    # description: The rootd daemon allows remote access to ROOT files.
   31    service rootd
   32    {
   33         disable = no
   34         socket_type             = stream
   35         wait                    = no
   36         user                    = root
   37         server                  = /usr/local/root/bin/rootd
   38         server_args             = -i /usr/local/root
   39         log_on_success          += DURATION USERID
   40         log_on_failure          += USERID
   41    }
   42 
   43    # file name: proofd
   44    # default: on
   45    # description: The proofd daemon is used to startup PROOF.
   46    service proofd
   47    {
   48         disable = no
   49         socket_type             = stream
   50         wait                    = no
   51         user                    = root
   52         server                  = /usr/local/root/bin/proofd
   53         server_args             = -i /usr/local/root
   54         log_on_success          += DURATION USERID
   55         log_on_failure          += USERID
   56    }
   57 
   58    In above examples correct daemon path to reflect your setup.
   59 
   60    Restart (x)inetd or force it to re-read the config file
   61    (kill -1 <inetd.pid>).
   62 
   63 
   64 3) (Optional) add to /etc/syslog.conf on the master node the line:
   65 
   66    local5,local6.debug     /usr/local/root/proof/log/proof.log
   67 
   68    and all slave nodes:
   69 
   70    local5,local6.debug     @master.cern.ch
   71 
   72    where master.cern.ch is domain name of the master node.
   73    All PROOF syslog messages will be collected on the master node.
   74    Just make one node in the cluster the master, all others are slaves.
   75    And change on all nodes the line:
   76 
   77    *.info;mail.none;news.none;authpriv.none  /var/log/messages
   78 
   79    to:
   80 
   81    *.info;local5,local6,mail.none;news.none;authpriv.none  /var/log/messages
   82 
   83    Create an empty /usr/local/root/proof/log/proof.log.
   84 
   85    Restart syslogd or force it to re-read the config file
   86    (kill -1 <syslogd.pid>).
   87 
   88 
   89 4) Edit /usr/local/root/proof/etc/proof.conf to reflect your cluster
   90    configuration. See the example proof.conf file for more information.
   91    Use hostnames consistent with the configuration of the hosts
   92    (fully qualified or non-qualified names).
   93 
   94 
   95 5) This is all. To test PROOF try the following:
   96 
   97    % root
   98    root [1] TProof::Open("<master.node.ch>")
   99    root [2] gProof->Print()
  100    <shows information on the master and all active slave servers>
  101    root [3] .q
  102 
  103 6) (Optional) Edit /usr/local/root/proof/etc/motd  (Message of the day)
  104    The contents of this file will be displayed in the client when a
  105    PROOF session is started.
  106 
  107 7) (Optional) To disable the use of the cluster temporarily you can
  108    create the file /usr/local/root/proof/etc/noproof. When a user
  109    tries to start a PROOF session the contents of the file will be
  110    displayed and no session will be started.
  111 
  112 ==================================
  113 
  114 The /usr/local/root/proof/utils directory contains some useful
  115 shell scripts for managing your cluster. They use the file
  116 /usr/local/root/proof/etc/cluster.conf to define the hosts they
  117 operate on.
  118 
  119 (As an alternative, some people are happy using dsh (distributed
  120 shell) from http://dsh.sourceforge.net)
  121 
  122 Files distributed with /usr/local/root/proof/utils/push:
  123 
  124 /etc/passwd
  125 /etc/group
  126 /etc/exports
  127 /etc/services
  128 /etc/inetd.conf