|
Steve's Notes
Installing & Running Athena (Release 15.6.4.3)
|
Athena |
VP1 |
DQ2 |
Wire Sag |
UM Cluster
Introduction
This is an informal summary of notes on installing and running Athena. It currently works for CERN (lxplus) and UMT3 (University of Michigan Tier 3 Cluster). It is complementary to the existing documentation found on the
WorkBook with a focus on providing a set of cut & paste examples. Please send comments and corrections to
Steven.Goldfarb@cernNOSPAMPLEASE.ch.
Set Up the CMT Environment
Here we define and export variables for CMT. The correct version of CMT to use for any particular release is found on the
Offline Release Status Page. In this example, we will use
Release 15.6.4. The corresponding version of CMT is
v1r20p20090520.
- Login to the appropriate machine (the "-Y" option passes the necessary X-Window information)
CERN> ssh -Y myusername@lxplus.cern.ch
UMT3> ssh -Y myusername@umt3int03.physics.lsa.umich.edu (can also use umt3int01 or umt3int02)
- Setup the cmt environment corresponding to the release (do whenever there is a new version of CMT)
CERN> source /afs/cern.ch/sw/contrib/CMT/v1r20p20090520/mgr/setup.sh
UMT3> source /atlas/data08/OSG/APP/atlas_app/atlas_rel/15.6.4/CMT/v1r20p20090520/mgr/setup.sh
Set Up the Athena Environment
This sets up the Athena working environment. More details at
WorkBookSetAccount .
- Create a directory structure (do this once for the release)
mkdir -p ~/TestArea/15.6.4.3/cmthome
cd ~/TestArea/15.6.4.3/cmthome
- Download the appropriate requirements file:
- Configure cmt (creates the scripts for setting up the environment):
cmt config
- Setup the Athena environmental variables: (every time you login)
source ~/TestArea/15.6.4.3/cmthome/setup.sh
- Check the CMT variables:
echo $CMTCONFIG
CERN> i686-slc4-gcc34-opt
UMT3> i686-slc5-gcc43-opt
echo $CMTPATH
CERN> ~/TestArea/15.6.4.3:/afs/cern.ch/atlas/software/releases/15.6.4/AtlasProduction/15.6.4.3
UMT3> ~/TestArea/15.6.4.3:/atlas/data08/OSG/APP/atlas_app/atlas_rel/15.6.4/AtlasProduction/15.6.4.3
Check Out the UserAnalysis Package
Analysis is typically run from within this package. Here we do a quick test with Hello World.
- If not done already, set up the environmental variables.
cd ~/TestArea/15.6.4.3
source cmthome/setup.sh
- Find out which version of UserAnalysis to checkout (in this case UserAnalysis-00-14-03):
cmt show versions PhysicsAnalysis/AnalysisCommon/UserAnalysis
- On UMT3, get kerberos permission (using CERN afs password):
UMT3> source ~daits/setups/svn_cvsg.sh
- Checkout, configure and build the package.
cmt co -r UserAnalysis-00-14-03 PhysicsAnalysis/AnalysisCommon/UserAnalysis
cd PhysicsAnalysis/AnalysisCommon/UserAnalysis/cmt
source setup.sh
gmake
Test the UserAnalysis Package
See more detailed instructions at
WorkBookReconstruction . This example will create ESD and AOD files from a simulated RDO file.
- Set up Athena and UserAnalysis environments: (once per login)
cd ~/TestArea/15.6.4.3
source cmthome/setup.sh
cd PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
source ../cmt/setup.sh
- See what options you can run with:
athena -h
- Try running Hello World: (See WorkBookRunAthenaHelloWorld for explanation of output)
get_files -jo HelloWorldOptions.py
athena HelloWorldOptions.py
- Copy some example files to the run area:
RecExCommon_links.sh
- Run the default jobOptions: (the -s option gives output from all included jobOptions)
athena -s | tee athena.log
Run Reconstruction on a Stripped Cosmic Bytestream Data File (only Muon data)
- Set up Athena and UserAnalysis environments: (once per login)
cd ~/TestArea/15.6.4.3
source cmthome/setup.sh
cd PhysicsAnalysis/AnalysisCommon/UserAnalysis/run
source ../cmt/setup.sh
- Download a small stripped bytestream data file and some example jobOption files from this wiki page:
- Create an ESD (with alignment correction on) from the bytestream file:
athena -s makeESD_align.py | tee makeESD_align.log
- Create an ESD (w/o alignment correction on) from the bytestream file:
athena -s makeESD_noalign.py | tee makeESD_noalign.log
Note: Output is visible on the screen and is written to the log file.
Find data sets with DQ2 at CERN
See my notes at
StevenGoldfarbDQ2 for details.
Install and View Data with VP1
See my notes at
StevenGoldfarbVP1 for details.
References
Major updates:
StevenGoldfarb - 29 Jan 2009 (creation)
--
StevenGoldfarb - 02 Feb 2009 (updated for demo)
--
StevenGoldfarb - 04 Feb 2009 (updated to 14.5.1)
--
StevenGoldfarb - 21-Mar-2010 (updated to 15.6.4.3)