Runtime Documentation

L2 monitoring Scripts:

All L2 algorithms are run via a single script monitorDaemon.  You can reach the monitoring account through the following steps (use -X -A flags on all steps):

  • ssh -X -A -Y rssh.rhic.bnl.gov
  • ssh -X -A  stargw.starp.bnl.gov (you may need to specify stargw1.starp.bnl.gov or stargw2.starp.bnl.gov)
  • ssh -X -A  onlmon@onl02.starp.bnl.gov

If you do not have permission to log on as onlmon, you can request access to onlmon at https://www.star.bnl.gov/starkeyw.

If the scripts need to be restarted do these commands as onlmon on onl02:

  • cd L2algo2012
  • monitorDaemon >& /dev/null ; bg ; exit

If this starts garbling data, the cleanUp command in the same directory will clear out all data and monitorDaemon can then be started completely from scratch.  Files to be accessed online are stored in /onlineweb/www/L2algo2012/l2jetHigh.

Original L2 doumentation https://drupal.star.bnl.gov/STAR/subsys/trg/l2
Maxance's L2 Monitoring "How To"  is attached at the bottom.

 L2 Tower Masks

Here is how to update the towerMask out of the L2 algorithms:

  • ssh -X -A operator@daqman.starp.bnl.gov (pw4*DAQops)
  • cd /RTS/conf/L2/emc_setup/
  • cp towerMask.pp_mo_day_yr towerMask.pp_mo_day_yr (copy last/latest file to today's date)
  • emacs -nw towerMask.pp_mo_day_yr (do not use 'vi' editor, add new tower mask to new file)
  • rm towerMask.pp_mo_day_yr (remove old file)
  • ls -s towerMask.pp_mo_day_yr towerMask_current (link to new file to current mask)

BTOW people use SoftID to indicate channels in hardware and software. To us, this is a number from 1-4800,
which is the number of PMTs in the BTOW. When Oleg or I mask a new tower, we will announce it in the electronic
run log, giving the SoftID number and alerting L2 that they have to mask it as well. If we mask it in hardware/L0,
you still have to mask it in L2.

However, Jan Balewski uses a different numbering system than SoftID. His notation, uses the form ##ll##.
If the letters are CAPITAL, this indicates an ENDCAP tower. If lower case, it indicates the barrel. Let us call
this the 'towerID'.

If you obtain the hot tower towerID in his format, then you simply go to the towerMask#### file and edit it as before.
If you obtain the SoftID as a number from 1-4800, then you can find the number in his format by 'grepping'
one of his L2ped files. In this file, the first column is the towerID in his notation, the SoftID is the
6th column. So for example, if Oleg tells you that he masked SoftID 1382. You can then type:

cat run12042002.l2ped.log|grep 1382

Looking at the (2) instances that this number appears in the text, we find the line:

12td27 45 1.7 0x10 0x2e id267-057-07 1382 ,.......*.......>...............

The 6th column is 1382, so that is the SoftID. The 1st column is 12td27. So to mask out this tower
you would edit the towerMask.pp_mo_day_yr file and add the line
12td27 0x0f 0x0f

if you put a '#' a the start of the line, it ignores that line.

L2ped - output linked to http://online.star.bnl.gov/L2algo/l2ped/index.html

Pedestals are calculated for every run and residuals are monitored. These pedestals serve as input to physics L2 algos and the HLT.  When necessary new pedestals need to be updated.  This is done by updating links that live in daqman:/RTS/conf/L2/emc_setup/ so that they point at the most recent log files from L2.

From stargw or another node on starp network login to daqman and move to L2 setup file directory:

Copy and link new reference peds (where DDD=day and RRR=runNumber,EVB=eventBuilder# 1-4):

  • cp /data/l2AlgoPlots/YYYY/DDD/runRRR.l2ped.EVB.log ./YYYYhistory/
  • $ ln -sf YYYYhistory/runRRR.l2ped.EVB.log pedestal.current

Print first few lines from new peds to check the run number is correct:

  • $head pedestal.current

email emc2-hn hypernews to alert crew and emc group that pedestals have been changed.  

BSMD Online Monitoring -http://online.star.bnl.gov/bsmdStatus/

Monitors BSMD pedestals (obviously before zero suppression)

Log on to onl02.starp.bnl.gov

onl02.ldaphome/onlmon/bsmd2012/

The file 'tellme' gives the command to execute

If it is not working, then kill the Bsmd process already running.

python runOnlineBsmdPSQA.py -n 1000000 -m /evp/ &

 http://drupal.star.bnl.gov/STAR/blog/wleight/2009/sep/01/run-9-bsmd-online-monitoring-documentation