Revision as of 16:31, 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.

1. Log into the hdsys account.

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

$ cd /gluex/builds
$ mkdir theRelease

$ cd theRelease
$ mkdir packages

$ cd packages

1. 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

1. 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

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

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

1. 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"

1. 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 

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

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

1. 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)

1. Build everything:

$ scons 

1. Install everything

$ scons install INSTALL_DIR=/gluex/builds/theRelease

1. Currently Java code must be build separately, until this is fixed:

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