Revision as of 16:37, 15 May 2013

How To Make an Online Release with SCONS

Introduction

Official online releases must be made from the hdsys account. You can make a release in your own area by following the instructions below, with some obvious modifications.

Eventually much of this will be automated.

• Log into the hdsys account.

• Go to the official release area, create a new release directory structure:

$ cd /gluex/builds
$ mkdir theRelease

$ cd theRelease
$ mkdir packages

$ cd packages

• Check out the buildScripts package and create top-level SConstruct file:

$ svn co https://halldsvn.jlab.org/repos/trunk/online/packages/buildScripts
$ cp buildScripts/scripts/SConstruct_for_package_dir SConstruct

• Check out other packages:

$ svn co https://halldsvn.jlab.org/repos/trunk/online/packages/somePackage
... check out more packages if desired ...

$ ls 
somePackage/ buildSCripts/  SConstruct

• Set path to point to gcc 4.8.0 (or whatever compiler you want):

$ setenv PATH /apps/gcc/4.8.0/bin:"$PATH"

• Set LD_LIBRARY_PATH for this compiler:

$ setenv LD_LIBRARY_PATH /apps/gcc/4.8.0/lib64:/apps/gcc/4.8.0/lib:"$LD_LIBRARY_PATH"

• Set PYTHON path to point to build scripts previously checked out (later these scripts will be released into another area, but for now assume they don't exist):

$ setenv PYTHONPATH /gluex/builds/theRelease/packages/buildScripts/scripts 

• Set PERL path to point to build scripts, also will be released later:

$ setenv PERL5LIB /gluex/builds/theRelease/packages/buildScripts/scripts

• Set environment variables needed for the build (note that eventually a system script will take care of this step):

$ setenv CMSG /gluex/coda_install-dir/Linux-x86_64
(set others as needed, e.g. for EVIO, ET, CODAOBJECT, etc)

• Build and install everything (except Java, see below):

$ scons 
$ scons install INSTALL_DIR=/gluex/builds/theRelease

• Currently Java code must be built separately, until this is fixed do the following:

$ scons java
$ scons install INSTALL_DIR=/gluex/builds/theRelease