Getting Started with the GlueX Analysis Software on the JLab CUE

From GlueXWiki
Revision as of 16:03, 4 October 2014 by Pooser (Talk | contribs)

Jump to: navigation, search

Scope

  • Here we discuss the methods necessary to acquire, build, and install the GlueX Analysis Software.

Acquiring the Software

  • Begin by logging into the JLab network
ssh user@login.jlab.org
  • Log in to the ifarm of you choice
ssh ifarm1101
  • Descend into the HallD work directory
cd /work/halld/home/
  • Create a directory for yourself
  • Perform an ls and look at some of the existing directories for examples. It should be quite obvious,
  • After descending into the directory you created for yourself you need to create a new work directory named whatever you like. For example:
mkdir Hall-D
  • Descend into that directory and do a subversion check out of the latest sim-recon
svn co https://halldsvn.jlab.org/repos/trunk/sim-recon

Building the Software

  • When done you need to setup the proper environment variables needed for the build. To do this it is best to just copy the appropriate set up script into your current working directory.
cp /group/halld/Software/builds/sim-recon/sim-recon-DATE/Linux_CentOS6-x86_64-gcc4.4.6/setenv.csh .
  • It is important to note that the OS you are running depends where you are on the JLab network. If you do not know this you need to execute the script osrelease.pl script which will provide that information for you. This is done with the following command:
./path-to/sim-recon/src/BMS/osrelease.pl
  • The string output will then inform you of the environment you should build.
  • Now that the setup script is in your current working directory you need to modify the location of the HALLD_HOME environment variable to point to the location of your newly checked out subversion of sim-recon. It should look something like the following:
setenv HALLD_HOME /w/halld-scifs1a/home/user/path-to/sim-recon
  • Now you want to source the setenv.csh script to set the approipriate environment for the build. This is done with the following:
source setenv.csh

Installing the Software

  • To perform the installation you want to descend into the directory /path-to/sim-recon/src and perform the build with the following command:
scons -j32 install
  • After performing a top-level build one can modify source and invoke "scons -u install" only in the specific sub-directory without having to do a top-level build every time.
scons -u install
  • Once the scons install is complete type hdgeant to be sure that the installation was correct.