AtlasKlientdriftWalkthrough
Walkthrough: Setting up ATHENA on a central managed computers
The purpose of this walk through is to create a working *ATHENA* setup on the scratch disk of one of the centrally managed *Fedora 8* machines. This walk through works successfully on on my desktop machine iftsub041012. I've assumed you are using bash, if you're using csh, change *.sh to *.csh, and all variable definitions from export A=b to set A b. If you are not using a Fedora 8 machine, things may not work. In the case of using a Scientific Linux 4 machine, you can skip the legacy compiler step and the --pretend-platform flag to pacman.
Installing ATHENA
The ATLAS offline software ATHENA can be installed by following the steps described in this section. For your convenience the steps are also implemented in the following script [%ATTACHURL%/setup_install.sh setup_install.sh]
Decide on a version to use and set up directories
The latest stable version of ATHENA when writing this was 13.0.40. You'll need a writable directory on a disk with lots of available space to install (~6.5 Gb), for this an external disk or the /scratch partition is very useful. To simplify things declare some environment variables and create the directory
export VERSION=13.0.40
export BASEDIR=/scratch/ATLAS
export INSTALL=${BASEDIR}/ATLAS_${VERSION}
mkdir -p ${INSTALL}
Legacy compilers
Fedora 8 is almost compatible with slc4 if you use the _legacy compilers_ gcc34 and g++34 (gcc 3.4.6) instead of the default compilers gcc and g++ (gcc 4.1.2). To do this place links in to the legacy compilers named as the default compilers in front of your path
mkdir -p ${INSTALL}/mybin
cd ${INSTALL}/mybin
ln -s /usr/bin/g++34/g++
ln -s /usr/bin/gcc34/gcc
export PATH=${INSTALL}/mybin/:$PATH
Install and run pacman
pacman is a package installer available from http://physics.bu.edu/pacman/ . Install it by running
cd ${INSTALL}
wget http://physics.bu.edu/pacman/sample_cache/tarballs/pacman-latest.tar.gz
tar xfvz pacman-latest.tar.gz
To install run
cd ${INSTALL}/pacman-*
source setup.sh
cd ${INSTALL}
VERSION_=`echo ${VERSION} | sed 's,\.,_,g'`
pacman -allow trust-all-caches -pretend-platform SLC-4 -V -get am-CERN:AtlasOffline_${VERSION_}_i686_slc4_gcc34_opt
answer yall to say yes to all questions (safe for a fresh install).
Note: Installing ATHENA takes a while (even with a fast internet connection)
Creating a workarea to work on
A workarea using the ATHENA installation can be created by the steps in this section For your convenience the steps are also implemented in the following script [[%ATTACHURL%/setup_workarea.sh][setup_workarea.sh]]
Prepare environment
First set environment variables and create a workarea directory
export VERSION=13.0.40
export BASE=/scratch/ATLAS
export WORKAREA=${BASE}/workarea_${VERSION}
export INSTALL=${BASE}/ATLAS_${VERSION}
export PATH=${INSTALL}/mybin:${PATH}
mkdir -p ${WORKAREA}
Create a requirements file
The requirements file is used by cmt, it must have the path $WORKAREA/requirements. The following file was adapted from https://twiki.cern.ch/twiki/bin/view/Atlas/WorkBookSetAccount (note that SITEROOT should match your $INSTALL directory)
set CMTSITE STANDALONE
set SITEROOT /scratch/ATLAS/
macro ATLAS_TEST_AREA /scratch/workarea
macro ATLAS_DIST_AREA ${SITEROOT}
apply_tag projectArea
macro SITE_PROJECT_AREA ${SITEROOT}
macro EXTERNAL_PROJECT_AREA ${SITEROOT}
apply_tag opt
apply_tag setup
apply_tag simpleTest
use AtlasLogin AtlasLogin-* $(ATLAS_DIST_AREA)
set CMTCONFIG i686-slc4-gcc34-opt
It is important to get set SITEROOT /scratch/ATLAS/ and macro ATLAS_TEST_AREA /scratch/workarea to point to your ATLAS software installation and workarea correct.
Prepare workspace
Use CMT to prepare for running
cd /scratch/workarea source /scratch/ATLAS/CMT/*/mgr/setup.sh cmt config . setup.sh -tag=$VERSION mkdir $VERSION
once this is done, you can run the root bundled with the production packages directly from the prompt.
You have to initialize the environment before each use, to make things easier create a script mysetup.sh that does all the steps for you
export VERSION=13.0.40
export BASE=/scratch/ATLAS
export WORKAREA=${BASE}/workarea_${VERSION}
export INSTALL=${BASE}/ATLAS_${VERSION}
source setup.sh -tag=${VERSION}
export PATH=${INSTALL}/mybin:${PATH}
and before using your environment just do source mysetup.sh
Adding packages to workspace
How to install packages is also described in the wiki page GettingStartedWithAthena, remeber to source to /scratch/workarea/mysetup.sh before compiling! Packages are availible in the cvs http://atlas-sw.cern.ch/cgi-bin/viewcvs-atlas.cgi/offline/ Make sure that the version of the packages you download are compatible with your ATHENA release! Add the cvs sub-directory to the workspace and unpack downloaded tar-ball there
mkdir -p ${WORKAREA}/${VERSION}/SubDirectory
cd mkdir ${WORKAREA}/${VERSION}/SubDirectory
#download package here
tar xfvz Package.tar.gz
it is not safe to remove the tar-ball. Next configure and build package
cd Package/cmt cmt config source setup.sh gmake
Adding SUSYDPDMaker to your workarea
These instructions are based on text found on the twiki page https://twiki.cern.ch/twiki/bin/view/AtlasProtected/SusyDPDMaker and requires ATHENA 13.0.40 release to work. Before running remember to do source mysetup.sh in your workspace.
Make sure you have the PhysicsAnalysis directory in your workarea
pa_dir=${WORKAREA}/${VERSION}/PhysicsAnalysis
mkdir -p ${pa_dir}
then download unpack and install DPDUtils-00-00-09
cd ${pa_dir}
wget "http://atlas-sw.cern.ch/cgi-bin/viewcvs-atlas.cgi/offline/PhysicsAnalysis/DPDUtils.tar.gz?view=tar&pathrev=DPDUtils-00-00-09"
tar xfvz DPDUtils.tar.gz*
rm DPDUtils.tar.gz*
cd DPDUtils/cmt
cmt config
source setup.sh
gmake
and SUSYPhys/SUSYDPDMaker-00-00-04
mkdir -p ${pa_dir}/SUSYPhys
cd ${pa_dir}/SUSYPhys
wget "http://atlas-sw.cern.ch/cgi-bin/viewcvs-atlas.cgi/offline/PhysicsAnalysis/SUSYPhys/SUSYDPDMaker.tar.gz?view=tar&pathrev=SUSYDPDMaker-00-00-04"
tar xfvz SUSYDPDMaker.tar.gz*
rm SUSYDPDMaker.tar.gz*
cd SUSYDPDMaker/cmt
cmt config
source setup.sh
gmake
