Local User Setup

The following outlines how to install new or more recent versions of some of the software packages required for IPLT in one's $HOME directory. This might be necessary if root priviliges are hard to come by, or simply to avoid messing up the system. The following contains some linux specific stuff where indicated, but may be easily adapted to other Un*x systems:

For the purpose of discussion, the packages python, scons, and boost will be installed under $HOME/sft/.

Preparation

Create the directory $HOME/sft/bin and add it to you executable path (see below).

Create the directory $HOME/sft/src and download and unpack Python, Boost and SCons into it. You should have something like:

> ls $HOME/sft/src
boost-1.31.0/ Python-2.3.3/ scons-0.96.1/

Installing Python

Change into the python directory and install it with

cd $HOME/sft/src/Python-2.3.3
configure --prefix=$HOME/sft
make
make install

To test if the python installation worked, type which python. You should get '$HOME/sft/bin/python'

Installing SCons

Install scons:

cd $HOME/sft/src/scons-0.96.1/
python setup.py install

Test it with 'scons -v'. You should obviously get the version you downloaded, in this case 'v0.96.1'

Installing boost

Change into the boost directory, first install bjam (boost building tool), then the rest of boost.

# bjam
cd $HOME/sft/src/boost-1.31.0/tools/build/jam_src
sh build.sh
# adjust for non-linux
cp bin.linuxx86/bjam $HOME/sft/bin 
# boost
setenv PYTHON_ROOT $HOME/sft
setent PYTHON_VERSION 2.3
# adjust for non-linux
bjam "-sTOOLS=gcc" --prefix=$HOME/sft install 

Shell settings

In the end, your shell initialization should reflect this local software install.

'$HOME/.login' for tcsh users:

if ($?MANPATH == 0) then
    setenv MANPATH
endif
setenv MANPATH ${HOME}/sft/share/man:${MANPATH}

if ($?LD_LIBRARY_PATH == 0) then
        setenv LD_LIBRARY_PATH
endif
setenv LD_LIBRARY_PATH ${HOME}/sft/lib:${LD_LIBRARY_PATH}

setenv PATH ${HOME}/sft/bin:${PATH}

$HOME/.bash_login for bash users:

export MANPATH=$HOME/sft/share/man:$MANPATH
export LD_LIBRARY_PATH=$HOME/sft/lib:$LD_LIBRARY_PATH
export PATH=$HOME/sft/bin:$PATH

Usage in iplt

To use these packages for IPLT, add the following things to settings.py in the IPLT top-level directory. Please note that you must enter the full path to your home directory, since variables may not be used in scons option files.

EXTRA_INCLUDE_PATH = '/PATH/TO/HOME/sft/include'
EXTRA_LIBRARY_PATH = '/PATH/TO/HOME/sft/lib'

EXTRA_CC_FLAGS = '-g -Wall'

# adjust for non-linux
BOOST_LIBS_SUFFIX = '-gcc'