Date: Wed, 15 Feb 2006 10:36:01 -0600
From: Kurt Biery <biery@fnal.gov>
Subject: DQM demo success on UAF

Kaori and Alan,
Here are some notes on the DQM programs that I have succeeded in running
on the CMS LPC user analysis facility (UAF), including the web client!

As you probably know, Christos' DQM page is found at
http://cmsevf.web.cern.ch/cmsevf/DQM_doc/DQM_instructions.html.  I
started with this page, but there were a number of things that I needed
to do slightly differently.

In any case, here are the steps that I have used today:

1) log into the UAF
After an account was set up for me on the UAF (see
http://www.uscms.org/SoftwareComputing/UserComputing/GetAccountFermilab.html
if you need an account), I followed the instructions at
http://www.uscms.org/SoftwareComputing/UserComputing/ConnectUAF.html to
log into the UAF.  Basically, this consisted of obtaining a kerberos
ticket on my laptop ('kinit' on Linux) and then connecting to the UAF
('ssh cmsuaf.fnal.gov').  Unfortunately for me, 'ssh cmsuaf.fnal.gov'
doesn't work (it asks for a cryptocard number), so I usually end up
connecting directly to one of the nodes in the UAF cluster (see the list
athttp://cmssrv02.fnal.gov/ganglia/?r=hour&s=descending&c=US-CMS%2520FNAL%2520TIER
-1%2520UAF).  So, I use something like 'ssh cmswn072.fnal.gov' and that
works.

2) set up the environment
I created a special directory for this work called "cmsdaq".  In each
shell that I create for testing this stuff, I run 'source
/afs/fnal.gov/files/code/cms/setup/cshrc uaf'.  Following Wade's hint, I
run 'scramv1 list CMSSW' to see which versions of CMSSW are available on
the UAF.  (As of Wednesday morning, CMSSW_0_5_0_pre1 is available, so we
can use the latest scripts from Christos.  Last week, 0_5_0 was not
available on the UAF, so I used earlier DQM scripts.)  From the "Download
and run" section of the DQM web page
(http://cmsevf.web.cern.ch/cmsevf/DQM_doc/DQM_instructions.html#Download_run),
I downloaded the "running script", the "instructions", and the
"installation script".  ("Downloading" for me consists of two steps: 
saving the scripts from the web page to my laptop and then copying the
scripts from my laptop to the UAF.)  Today, I downloaded
"install_dqm_v010.sh", 'instruct_v010.sh", and "run_dqm_v010.sh" and
copied them to ~biery/cmsdaq on the UAF.

3) modify the scripts
In the "install" and "run" scripts, there are notes that instruct people
to replace a certain line if we are not "CVS developers".  The simple
substitution that the notes suggest did not work for me, but I found the
following to work:
 *  replace the line containing "project CMSSW"
 *  with two lines:
     +  set cvsbase =
        ":pserver:anonymous:98passwd@cmscvs.cern.ch:/cvs_server/repositories"
     +  setenv CVSROOT "${cvsbase}/CMSSW"
Do this in both install_dqm_v010.sh and run_dqm_v010.sh.  Also, enable
execute permission on the scripts (e.g. 'chmod +x *010.sh'.

4) install the code
 *  run 'source /afs/fnal.gov/files/code/cms/setup/cshrc uaf' if needed
 *  remove or rename <yourWorkArea>/DQM_devel if it already exists.  For
    me, I delete ~biery/cmsdaq/DQM_devel.
 *  cd to your work area.  For me, 'cd ~biery/cmsdaq'.
 *  './install_dqm_v010.sh'
At the end of the install script, "instruct_v010.sh" is executed, and it
prints out instructions on how to run a sample system.  The following
three sections contain my variation on these steps.

5) start the collector
 *  open a new shell window connected to cmsuaf, if needed
 *  run 'source /afs/fnal.gov/files/code/cms/setup/cshrc uaf', if needed
 *  'cd <yourWorkArea>/DQM_devel/CMSSW_0_5_0_pre1/bin/slc3_ia32_gcc323'
    (probably specific to DQM version 010)
 *  'eval `scramv1 runtime -csh`'
 *  'rehash'
 *  './DQMCollector'
6) start the source
 *  open a new shell window connected to cmsuaf, if needed
 *  run 'source /afs/fnal.gov/files/code/cms/setup/cshrc uaf', if needed
 *  'cd
    <yourWorkArea>/DQM_devel/CMSSW_0_5_0_pre1/src/DQMServices/Daemon/test/data'
    (probably specific to DQM version 010)
 *  'eval `scramv1 runtime -csh`'
 *  'rehash'
 *  'cmsRun dqm_source_example.cfg'
7) start the (local GUI) client
 *  open a new shell window connected to cmsuaf, if needed
 *  run 'source /afs/fnal.gov/files/code/cms/setup/cshrc uaf', if needed
 *  'cd <yourWorkArea>/DQM_devel/CMSSW_0_5_0_pre1/bin/slc3_ia32_gcc323'
    (probably specific to DQM version 010)
 *  'eval `scramv1 runtime -csh`'
 *  'rehash'
 *  './DQMClientExample'
8) start the web client
 *  open a new shell window connected to cmsuaf, if needed
 *  run 'source /afs/fnal.gov/files/code/cms/setup/cshrc uaf', if needed
 *  'cd
    <yourWorkArea>/DQM_devel/CMSSW_0_5_0_pre1/src/DQMServices/WebClient/test'
    (probably specific to DQM version 010)
 *  'eval `scramv1 runtime -csh`'
 *  'rehash'
 *  './setup.sh'  (only need to this once per creation of the DQM_devel
    directory tree)
 *  './startMonitorClient' (this runs for a short time and then exits. 
    If it throws a soap exception, then that probably means that the XDAQ
    executive is already running and set up.)
 *  open a browser window and go to http://cmswn072.fnal.gov:1972
 *  Select Control Panel --> View Applications --> Web Monitor
 *  On the Login screen, type in a user name, select Superuser, and click
    Submit
 *  On the Configuration form, enter the hostname of the collector
    (cmswn072.fnal.gov), the port (9090), and a name for the client
    (anything you want).  Then click Submit Configuration.
 *  In the left pane, navigate to "directory" Collector/FU0/C1/C2,
    subscribe to Collector/FU0/C1/C2/histo5, and view this same
    histogram.
 *  I haven't yet figured out how to stop the web client gracefully. 
    What I did today was to find all xdaq processes owned by me ('ps -fu
    biery | grep xdaq'), and then kill each one by hand (kill -9).
To stop demo applications other than the web client, I just control-C out
of them.

Let me know if you have questions or if we want to get together some time
and try this from the ROC.
Kurt