There are two sets of reference histograms used in online fast monitoring. These are the level3 histograms (a.k.a. IR2LiveL3) and the LiveFastMon histograms. These are used not only to display the reference plots in the JAS displays, but are also used for comparison in the automated fast monitoring that is shown in the cmlog browser on bfo-con05, middle display.

Each of these sets of histograms are stored in a reference file, which is read by an hbook server, and provided through CORBA to the JAS subsystem. The hbook servers are controlled (started and stopped) through the fast monitoring GUI that you see on bfo-con05 (lower display). The reference hbook files are found at the following locations:

/nfs/bbr-srv02/bfdist/MonitoringData/References/merged/IR2LiveL3-RUNTYPE.hbook

/nfs/bbr-srv02/bfdist/MonitoringData/References/merged/LiveFastMon-RUNTYPE.hbook

where “RUNTYPE” is currently either COSMICS or PHYSICS. The list of runtypes may be extended in the future.

These hbook files are produced by merging individual references prepared by each subsystem, and stored in References/Xxx/IR2LiveL3/IR2LiveL3-<runtype>.hbook and References/Xxx/LiveFastMon/LiveFastMon-<runtype>.hbook. The preparation of the individual hbook files is beyond the scope of this document.

Although this is not required architecturally and so could change in the future, it is the case today that the merged IR2LiveL3.hbook comes entirely from L3TMonTools, and the merged LiveFastMon.hbook comes entirely from the other subsystems, so the contributions are for now mutually exclusive.

Once you have merged the hbook files, you must restart the reference server(s). Depending on which subsystem reference you have updated, you will need to start either the LiveFastMon reference (common) or the IR2LiveL3 reference (only for L3TMonTools), but usually not both.

Preparing to install

Before running the merge script, you need to copy your reference hbook file into the appropriate subdirectory. These are not kept in cvs, so no cvs operations are involved here. Note that the References directory in the self-service area is actually a link to a common references directory that does not change when new releases of the self-service area are installed. This common references area is generally used to hold historical copies of the reference hbook files.

Different subsystems have used different naming schemes for naming their historical reference files, so if you use this manual system, you should examine the directory References/Xxx/LiveFastMon and name your new file accordingly. If you use the LfmUpdateGui interface and you ask it to copy the hbook file for you, it will simply name the file “LiveFastMon-YYYYMMDD-HHMMSS”. Using the manual method, do something like this (I am using the Emc as the example – your mileage may vary):

cd /nfs/bbr-srv02/bfdist/MonitoringData/References/Emc/LiveFastMon

cp <new hbook file> emc_ref_run12345.hbook

rm LiveFastMon-PHYSICS.hbook

ln -s emc_ref_run12345.hbook LiveFastMon-PHYSICS.hbook

Now you are ready to run the merge script.

Installing your changes

Once you have prepared your hbook file and placed it in the self-service area as described above, you just need to run the install procedure. Just type the following:

/nfs/bbr-srv02/bfdist/MonitoringData/LiveFastMon-hbook-install

[ LiveFastMon | IR2LiveL3 ] [ PHYSICS | COSMICS ]

The second and third arguments are optional. If the third argument is missing, the install will be done for all run types. If the second argument is missing the default is LiveFastMon.

You will be prompted for a one-line description of your change. Once this is finished, you must restart the reference hbook server. This can be done by the DQM shifter via the FastMonControl gui on bfo-con05. Select the appropriate green button labeled “Reference” and choose “Restart” from the pulldown menu.

Now you can view the results in the JAS display.

Or use the convenient GUI interface instead

Note that most of the above steps can be done through an interactive gui interface that is described <here>. If you want to just try it without reading the documentation, just type this:

/nfs/bbr-srv02/bfdist/MonitoringData/LfmUpdateGui

Note that after doing this you must still restart the reference server as described above.