How to run DAQInterface at Oxford

The following are Oxford-specific instructions for running on the timing board at the Oxford teststand. They're valid as of this writing, Jun-26-2017. To install a new copy of dune-artdaq at the Oxford teststand, go to OxfordDuneArtdaqInstallation

Step-by-step instructions for running

The timing mode is run on lbnedaq4 - and not on the pplxdaq05 (which is the RCE node). Recall that there are several "layers" of computers to log into to get to lbnedaq4 these are (assuming you are already logged into an Oxford computer) dune-nat, pplxdaq05, and then 192.168.100.40 (you will need to know the passwords for these) - to just run the executable you will need two windows on lbnedaq4 - to run the executable AND view the output in realtime a third lbnedaq4 window will be needed.

• Open two terminals on lbnedaq4, logged in as "artdaq1". To get onto lbnedaq4 from pplxdaq05, type "ssh 192.168.100.40", and use the same password as you used to get onto pplxdaq05 as artdaq1.

* In terminal 1, launch DAQInterface by issuing the following commands:

source ~/products/setup
cd artdaq-utilities-daqinterface
. source_me
DAQInterface

• In terminal 2, type

source ~/products/setup
cd artdaq-utilities-daqinterface
. source_me
just_do_it.sh 0

• If you don't see any error messages in either terminal, the system is running. You can confirm this for yourself by looking at the logfile, which will be the most recent one in /tmp/pmt . In a 3rd terminal log into lbnedaq4 - once agin through all the layers, and then do "tail -f /tmp/pmt/whatever_the_logfilename_is" to view the logfile updating in real time.

• When you want to stop running, in terminal 2, type "Ctrl-c"

• In terminal 2, you might see something like the following:

Event count in saved metadata (-999) and event count in *.root files (2960) don't agree

This is a "known problem" and not a showstopper - the important thing is that there are events in the *.root file(s), assuming diskwriting is on.

Examining the output of the run

• The output *.root file is saved in /tmp
• The logfile, as mentioned above, is saved in /tmp/pmt
• A record of the run is saved in ~artdaq1/run_records/

Changing things

JCF, Jun-26-2017: disregard the instructions below

• just_do_it.sh is typically set up to run on just rce00. If you want it to run on rce01 as well, edit the line in ./bin/just_do_it.sh which looks like:

  $scriptdir/setdaqcomps.sh rce00

to look like

  $scriptdir/setdaqcomps.sh rce00 rce01

and if you want to add in the timing board, edit it to look like:

$scriptdir/setdaqcomps.sh rce00 rce01 timing

• If you wish to change the dune-artdaq package used, set the "DAQ directory" parameter in docs/config.txt to the base path of your dune-artdaq installation (i.e., the path which contains setupDUNEARTDAQ).

-- JohnChristianFreeman - 2017-06-26