The JAS fast monitoring displays are controlled by two kinds of file: html files that provide the page layout, and xml files that describe the plots and link them to specific histograms. Each subsystem provides a set of files of each type, contained within a CVS package named XxxMonTools.

The fast monitoring “self-service area” is always found at the path “/nfs/bbr-srv02/bfdist/MonitoringData. At that location you will find a checked out copy of each of the XxxMonTools packages, plus the OepTools package, which contains various executables that are used to maintain the self-service area. There is a subdirectory named “doc” which contains a copy of all of the html and xml files in the packages. The jas servers use the copy in doc, and not the top-level copies. You should never modify anything in the doc subdirectory, but instead must modify the packages at the top level and then install the changes.

When you change the plots or histograms, or the html for the layout of your fast monitoring pages, you must run an install procedure to activate the changes. The instll procedure essentially just copies all of the html and xml files from the top-level packages into matching subtrees in the doc directory. While making the copies, it substitutes the string “@NAVIGATIONBAR@” with html headers and footers containing standard links to the pages for other packages.

During the installation, the old doc directory is deleted and a new one is constructed. This can interfere with viewing the old pages, so you should advise the DQM shifter of your activities. Once the installation is done, the changes should be visible in JAS at the next refresh, or by following any link. There is no need to restart JAS or anything else.

Preparing to install

Before running the install, you must prepare a new tag of your package(s). You can do thisi in one of two ways.

Prepare your new tag in a separate test build. Test it there, commit it and tag it. For information on testing your html and xml files before you install, see this page.

If you choose this method, then do the following before you install:

cd /nfs/bbr-srv02/bfdist/MonitoringData/XxxMonTools

cvs update -d -r Vnn-nn-nn

Where Vnn-nn-nn is the new tag you just prepared.

Edit your changes in place in the self-service area (not the doc subdirectory). Then commit and tag them in place. You can test them by running the install first if you prefer, but you must not forget to commit and tag the changes later. It is safest to commit before you install.

If you choose this method, do the following before you install:

cd /nfs/bbr-srv02/bfdist/MonitoringData/XxxMonTools

cvs update -A

< Edit your changes. Don't forget to edit History. >

cvs commit

cvs tag Vnn-nn-nn

cvs update -r Vnn-nn-nn

Please don't forget to do all of the above if you do this manually. Otherwise it can be annoying to discover later what tag is in use.

Installing your changes

Once you have prepared the new tag of your package 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-html-install

You will be prompted for a one-line description of your changes.

Now you are done, and 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