Instructions for Downloading and Installing HCPSS Software

Please bookmark this page as any instructions for updates can be found here.

Introduction

The tutoral on Monday is "Hands on." Fortunately, as this means different things to different people, we offer you the choice of being able to install software on your own laptop and playing with real MC analysis to the other extreme of spending all of your time analyzing the "final" plots.

One comment: This is designed to work on your laptop. If you don't have the space or the compilers, but you can connect to a (hopefully not too) remote computer, you can install the software there and simply connect to that during the tutorial.

Finally, with any questions, problems, suggestions, or anything you just feel like telling me, please feel free to email me at cplager+cmshelp@fnal.gov. If possible, please try to install the software before arriving. People will be available at 8:30 Monday morning for help and again, please don't hesitate to email me with questions at cplager+cmshelp@fnal.gov.

Windows

Linux and Mac

For this, you need Root (version 5.22 or greater), an X server, and the compiler that was used to compile root. Installing root is easy (although compiling can take a while). Installing the compilers is beyond the scope of these instructions.

Root

For this, you will need at least root 5.22. If you already have Root installed correctly, you can skip this step.

To install root:

cd somedir
wget ftp://root.cern.ch/root/root_v5.26.00c.source.tar.gz
tar xzf root_v5.26.00c.source.tar.gz
setenv ROOTSYS $PWD/root
setenv PATH $ROOTSYS/bin:$PATH
cd root
./configure
make

I am assuming you are using tcsh (if you don't know, you probably are). If you are using bash, you will need to export ROOTSYS=$PWD/root etc. instead.

ROOT on Mac

Note: Some macs may not have the compilers already installed (although it should be on CDs that you got with your mac). It is also possible to install them without the CDs (but I don't know how since I'm not a mac guy :-) )..

If you are on a mac, replace the wget command with curl -O

curl -O ftp://root.cern.ch/root/root_v5.26.00c.source.tar.gz
IMPORTANT: If you are running on OS 10.5, you need to make sure your root is compiled in 32 bit mode as that is the default mode for the compiler. To ensure this, please use ./configure macosx. For OS 10.6, the default is 64 bit, so please use ./configure macosx64.

Rest of HCPSS Software

cd whereIwant
wget http://hcpss.plager.net/hcpss_source.tgz
tar xzf hcpss_source.tgz
cd hcpss

(Again, mac users will need to use curl instead.)

At this point you need to edit setup.csh (or setup.sh if you are using bash) to tell it exactly where the hcpss directory is. I recommend running pwd and copying the location to edit the file.

AFter editting the file, simply source setup.csh (or . setup.sh) and your environment is now ready.

To build the software:

./buildPackages.bash |& tee build.out
for tcsh, or
./buildPackages.bash 2>&1 | tee build.out
for bash.

Note: If you are on a multi-core machine, you can get the make commands inside the above script to use mutiple threads by setting an environment variable JN (e.g., setenv JN -j16 says to use up to 16 threads at once).

Additional Mac Users Instructions

After running the above steps, mac users need to run the following commands:
cd $BASE_DIR
copyShlibs.py "CLHEP:CLHEP-\d" HepPDT HepPID fastjet SISConePlugin CDFConesPlugin siscone siscone_spherical --dest=shlib --ext=dylib

cd $BASE_DIR/shlib/
loop.pl "install_name_tool -id $PWD/% %" *.dylib *.so

Additional Linux User Instructions

Run the following commands:
cd $BASE_DIR/bin
wget http://hcpss.plager.net/copyShlibs.py.txt -O copyShlibs.py
cd $BASE_DIR
copyShlibs.py  --dest=shlib "CLHEP:CLHEP-\d" HepPDT HepPID \
   fastjet SISConePlugin CDFConesPlugin siscone siscone_spherical
cd $BASE_DIR/shlib
ln -s libCDFConesPlugin.so    libCDFConesPlugin.so.0     
ln -s libCLHEP.so             libCLHEP-2.1.0.0.so        
ln -s libfastjet.so           libfastjet.so.0            
ln -s libSISConePlugin.so     libSISConePlugin.so.0      
ln -s libsiscone.so           libsiscone.so.0            
ln -s libsiscone_spherical.so libsiscone_spherical.so.0  

Making Sure It Worked

cd $BASE_DIR/executables
make
wget http://hcpss.plager.net/john.root
./wjets.exe Process.config john.root

If you see something like

cplager@cmslpc03> ./wjets.exe Process.config john.root 
readConfigFile: Read in Configuration from file Process.config
readConfigFile: Parameter nevents=10000
readConfigFile: Parameter OutputFileName=HepMCReader_test.root
readConfigFile: Parameter InputFileNames=sample1.input
Then everything is good. If not, let me know what went wrong at cplager+cmshelp@fnal.gov and let me know what went wrong.

Fixing errors while loading shared libraries

On certain linux flavors, you may get the following error: ./wjets.exe: error while loading shared libraries: libCLHEP-2.1.0.0.so: cannot open shared object file: No such file or directory If you get this error, please copy and paste the following commands:

cd $BASE_DIR/shlib
ln -s libCDFConesPlugin.so    libCDFConesPlugin.so.0     
ln -s libCLHEP.so             libCLHEP-2.1.0.0.so        
ln -s libfastjet.so           libfastjet.so.0            
ln -s libSISConePlugin.so     libSISConePlugin.so.0      
ln -s libsiscone.so           libsiscone.so.0            
ln -s libsiscone_spherical.so libsiscone_spherical.so.0  

Fixing cannot find -lCLHEP on Linux

cd $BASE_DIR/bin
wget http://hcpss.plager.net/copyShlibs.py.txt -O copyShlibs.py
cd $BASE_DIR
copyShlibs.py  --dest=shlib "CLHEP:CLHEP-\d" HepPDT HepPID \
   fastjet SISConePlugin CDFConesPlugin siscone siscone_spherical
and try again. If that doesn't work, run cd $BASE_DIR; copyShlibs.py --printAll and email me

Sharing A Software Installation

If you are unable to install this on your own computer, but you have access to another computer where this is already installed, you can still complete all of the exercises. To do this, you will want to setup the environment for that build. After that:

cd someDirectoryIcanWrite
cp -r $BASE_DIR/executables .
cd executables
make

Locations:


Last modified: Thu Jul 7 14:59:48 EDT 2011