Page History

This document describes the steps required to build ApacheTrafodion software.

<TDB: change hardcoded version number 1.3.0 to be configurable>

Table of Contents

Supported Platforms

...

1. Java version is compatible, it must be 1.7.x. To check your version, do "java -version". Ensure JAVA_HOME environment variable exists and set to your JDK installation.

2. Verify that Trafodion source is downloaded and un-tarred,  or cloned from github.  In these instructions, this location is referred to as <trafodion source directory>.
3. Download, build and install additional development tools via  Additional Build Tools.
4. Maven version 3.0.5 or greater is installed and part of your path. To check your version, do "mvn --version".

...

•  core file size                    (blocks, -c) 1000000
• data seg size                    (kbytes, -d) unlimited
• scheduling priority            (-e) 0
• file size                             (blocks, -f) unlimited
• pending signals                (-i) 515196
• max locked memory         (kbytes, -l) 49595556
• max memory size             (kbytes, -m) unlimited
• open files                          (-n) 32000
• pipe size                           (512 bytes, -p) 8
• POSIX message queues  (bytes, -q) 819200
• real-time priority               (-r) 0
• stack size                         (kbytes, -s) 10240
• cpu time                           (seconds, -t) unlimited
• max user processes         (-u) 267263
• virtual memory                 (kbytes, -v) unlimited
• file locks                           (-x) unlimited

Build Steps

If you are downloading a source tar file, then, by default,  your <trafodion source directory> is apache-trafodion-1.3.0-incubating.  If you are getting source from the git repository, then, by default, your <trafodion source directory> is incubator-trafodion.

Set up Trafodion

...

tool locations

Additional development tools are required before building Trafodion  as described Additional Build Tools.  A convenience script script exists that downloads, installs, and builds all these tools in a common directory.  If  It is recommended that you use this convenience script.  Once completed, export your TOOLSDIR:

   export TOOLSDIR=<tools installation directory>

If this convenience script is not used or if any of these additional build tools are not found in the expected location, then the Trafodion configuration file needs to be updated. The Trafodion configuration file template is located in <download directory>/apache-trafodion-1.3.0-incubating/core/sqf/LocalSettingsTemplate.sh.  To change values, copy this file to your home directory and change its name to .trafodion.  Edit the .trafodion file and update according to the instructions.  Be sure to change the location of your TOOLSDIR to your <tools installation directory>.

   cp <download directory>/apache-trafodion-1.3.0-incubating/core/sqf/LocalSettingsTemplate.sh ~/.trafodion

...

you need to export the location of each tool as follows:

   export BISON="<bison-location>/bison_3_linux/bin/bison"
   export LLVM=<llvm-location>/dest-llvm-3.2"
   export UDIS86="<udis-location>/udis86-1.7.2"
   export ICU="<icu-location>/icu4.4"
   export MPICH_ROOT="<mpich-location>/dest-mpich-3.0.4"
   export ZOOKEEPER_DIR="<zookeeper-location>/zookeeper-3.4.5"
   export THRIFT_LIB_DIR="<thrift-location>/thrift-0.9.0/lib"
   export THRIFT_INC_DIR="<thrift-location>/thrift-0.9.0/include"

Build Trafodion

Start a new ssh session

    cd <download<trafodion source directory>/apache-trafodion-1.3.0-incubating
    export $TOOLSDIR=<tools installation directory>
    source ./env.sh

Note:  if you must export your TOOLSDIR don't export  TOOLSDIR before sourcing in env.sh or you will see missing dependencies at build time, Trafodion sets this variable to /opt/home/tools.  If the additional tools are not found in this location, the build will fail.

Build using one of the following options:

...

     make sure you have set up password less authentication. You should be able to "ssh localhost" without having to enter a password
     cd <download directory>/apache-trafodion-1.3.0-incubating<trafodion source directory>
     source ./env.sh

Install Hadoop, HBase, Hive, MySql, and Trafodion

...

Start a new ssh session and set up environment:

    cd <trafodion <downloadsource directory>/apache-trafodion-1.3.0-incubating
    source ./env.sh
    cd $MY_SQROOT/etc
    # delete ms.env, if it exists
    rm ms.env
    cd $MY_SQROOT/sql/scripts
    sqgen 

Start up Trafodion

Start a new ssh session and start Trafodion

    cd <download directory>/apache-trafodion-1.3.0-incubating<trafodion source location>
    source ./env.sh
    cd $MY_SQROOT/sql/scripts
    sqstart
    sqcheck 

...

Trafodion is up and running, you can now start up a SQL command line  interface and initialize Trafodion

Start a new ssh session, set environment and run the sqlci tool:

    cd <download<trafodion source directory>/apache-trafodion-1.3.0-incubating
    source ./env.sh
    sqlci 

...