Instructions to Build SPLOT

Create directory "splot-build"

• Make this directory anywhere you want
• This is the place all splot stuff and its dependent libs will sit

Build ACE

• Download ACE source code, e.g. ACE-5.5.tar.gz, from this site: http://download.dre.vanderbilt.edu/

• Move the compressed source code (e.g. ACE-5.5.tar.gz) to the directory "splot-build"

• Unzip the source code and you will have this directory: ACE_wrappers

 gunzip ACE-5.5.tar.gz
 tar xvf ACE-5.5.tar

• Set environment variable: ACE_ROOT. For instance, in .bash_profile, add

 ACE_ROOT=/home/hliu/projects/splot-build/ACE_wrappers
 export ACE_ROOT

• Add ACE lib to environment variable: LD_LIBRARY_PATH. For instance, in .bash_profile, add

 LD_LIBRARY_PATH=$ACE_ROOT/lib:$LD_LIBRARY_PATH
 export LD_LIBRARY_PATH

• Create a configuration file, config.h, in $ACE_ROOT/ace. Config.h will contain only the following line:

 #include "ace/config-linux.h"

This file includes the appropriate platform/compiler-specific header configurations from the ACE source directory.

• Create a build configuration file, platform_macros.GNU, in $ACE_ROOT/include/makeinclude. Platform_macros.GNU will contain only the following line:

 include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU

This file contains the compiler and Makefile directives that are platform/compiler-specific.

• Run "make" in the ACE_ROOT directory

The compiling failed in building $ACE_ROOT/ACEXML/examples/SAXPrint. But the ACE libraries are already built in $ACE_ROOT/lib.

Build xerces

• Download "xerces-c-src_2_7_0.tar.gz" from: http://archive.apache.org/dist/xml/xerces-c/source/ into the directory "splot-build"
• Unzip the source code and you will have this directory: xerces-c-src_2_7_0

 gunzip xerces-c-src_2_7_0.tar.gz
 tar xvf xerces-c-src_2_7_0.tar

• Set environmental variable: XERCESCROOT. For instance, in .bash_profile, add:

 XERCESCROOT=/home/liu/projects/splot-build/xerces-c-src_2_7_0
 export XERCESCROOT

• Run autoconf

 cd $XERCESCROOT/src/xercesc
 autoconf

• In the same directory,

 ./configrue
 make

• You will see libraries built in $XERCESCROOT/lib

Build scons

• Download scons from http://www.scons.org/download.php and unzip it into the directory "splot-build"
• Change directory to the scons root directory, e.g. scons-0.96.1

 cd /home/surg/projects/splot-build/scons-0.96.1

• Intall scons. For instance, run

 python setup.py install --prefix=/home/surg/projects/splot-build/scons-0.96.1

• Intall scons libs. For instance, run

 python setup.py install --standard-lib --prefix=/home/surg/projects/splot-build/scons-0.96.1

• Set PATH for /home/surg/projects/splot-build/scons-0.96.1/bin

Build opentracker

• Download opentracker 2.0 from

 svn co --username otreader https://svn.icg.tu-graz.ac.at/svn/opentracker/trunk opentracker

Press "t" to temporarily accept the certificate. Input OPEN4read when prompted for password.

• Have a copy of ICGBuilder

• Make a symlink in your opentracker directory to 'ICGBuilder'

• Set the environment variables XERCESROOT and ACEROOT

• You will need to add xerces library path to your LD_LIBRARY_PATH to build the middleware executable (we don't really need this)

• Run scons in the OpenTracker root directory