Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Describes how to download, build, and install build tools required for Apache Trafodion. |
Table of Contents |
---|
Configurable Installation
The location of the tools is configurable and can be specified in the Trafodion configuration file. The Trafodion configuration file template is located in:
<Trafodion download directory>/incubator-trafodion/core/sqf/LocalSettingsTemplate.sh.
Following the directory structure shown in the template file makes it easier to specify the location of these tools for the build. This means you will only need to set the TOOLSDIR environment variable to the value of the common parent directory before building Trafodion.
Required Build Tools
Several tools need to be downloaded, built, and installed:
Tool | Description |
---|---|
MPICH | An implementation of the Message Passing Interface (MPI) standard. For use in Trafodion, MPICH must be built to force sockets to be used in both internode and intranode message passing. |
Bison | General-purpose parser generator. |
Udis86 | Minimalistic disassembler library (libudis86) for the x86 class of instruction set architectures. |
LLVM | Collection of modular and reusable compiler and toolchain technologies. |
ICU | Setup of C/C++ and Java libraries providing Unicode and Globalization support for software applications. |
Zookeeper | Coordination service for distributed applications. It exposes common services such as naming, configuration management, synchronization, and group services. |
Thrift | Communications and data serialization tool. |
Maven | Build tool that is only installed if compatible version does not exist. |
You can install these tools using one of the following methods:
...
Required Build Tools
Several tools need to be downloaded, built, and installed:
Tool | Description |
---|---|
MPICH | An implementation of the Message Passing Interface (MPI) standard. For use in Trafodion, MPICH must be built to force sockets to be used in both internode and intranode message passing. |
Bison | General-purpose parser generator. |
Udis86 | Minimalistic disassembler library (libudis86) for the x86 class of instruction set architectures. |
LLVM | Collection of modular and reusable compiler and toolchain technologies. |
ICU | Setup of C/C++ and Java libraries providing Unicode and Globalization support for software applications. |
Zookeeper | Coordination service for distributed applications. It exposes common services such as naming, configuration management, synchronization, and group services. |
Thrift | Communications and data serialization tool. |
Maven | Build tool that is only installed if compatible version does not exist. |
log4cxx | standard logging framework for C++ |
hadoop | shared libraries for libhadoop, libhdfs, and hdfs header file |
You can install these tools using one of the following methods:
- traf_tools_setup.sh installation: a script that uses wget to download the appropriate tar file, builds, and installs the required tool into a directory of your choice for each tool listed above. The advantage of this method is that all the correct tools are downloaded and built in a single directory. Before building, a single environment variable needs to be set called TOOLSDIR.
Manual installation: if one or more of these tools are already installed in your environment or if you want to verify the download location before accepting software, then you can install each tool separately. The advantage of this method is you don't have to reinstall tools that you already have installed. However, there may be an issue with incompatibility between the existing tools and versions required by Trafodion. If you choose this method, you need export the following variables before building:
export BISON="<tool location>/bison_3_linux/bin/bison"
export LLVM="<tool location>/dest-llvm-3.2"
export UDIS86="<tool location>/udis86-1.7.2"
export ICU="<tool location>/icu4.4"
export MPICH_ROOT="<tool location>/dest-mpich-3.0.4"
export ZOOKEEPER_DIR="<tool location>/zookeeper-3.4.5"
export THRIFT_LIB_DIR="<tool location>/thrift-0.9.0/lib"
export THRIFT_INC_DIR="<tool location>/thrift-0.9.0/include"
export LOG4CXX_LIB_DIR="<tool location>/apache-log4cxx-0.10.0/lib"
export HADOOP_BLD_LIB="<tool location>/hadoop-2.6.0/lib/native"
export HADOOP_BLD_INC="<tool location>/hadoop-2.6.0/include"- traf_tools_setup.sh installation: a script that uses wget to download the appropriate tar file, builds, and installs the required tool into a directory of your choice for each tool listed above.
- Manual installation: if one or more of these tools are already installed in your environment or if you want to verify the download location before accepting software, then you can install each tool separately.
traf_tools_setup.sh Installation
...
Code Block | ||||
---|---|---|---|---|
| ||||
cd incubator-trafodion. <Trafodion source directory>/install ./traf_tools_setup.sh -h Usage: ./traf_tools_setup.sh -d <downloaddir> -i <installdir> -d <downloaddir> - location of download directory -i <installdir> - location of install directory -h - help example: traf_tools_setup.sh -d /home/userx/download -i /home/userx/tools |
...
Code Block | ||||
---|---|---|---|---|
| ||||
$ mkdir ~/download $ ./traf_tools_setup.sh -d ~/download -i ~/tools INFO: Starting tools build on Fri Nov 6 21:33:53 PST 2015 Tools install directory /home/gtappercentos/tools does not exist, do you want to to create it? y/n : y INFO: Created directory /home/gtappercentos/tools INFO: Tar download location: /home/gtappercentos/download INFO: Tool install directory location: /home/gtappercentos/tools INFO: LogFile location: /home/gtappercentos/incubator-trafodion/install/traf_tools_setup.log *********************************************************** INFO: Installing MPI on Fri Nov 6 21:34:00 PST 2015 INFO: downloaded tar file: mpich-3.0.4.tar.gz . . . INFO: downloaded tar file: apache-maven-3.3.3-bin.tar.gz INFO: Maven installation complete *********************************************************** INFO: Completed tools build on Fri Nov 6 22:23:22 PST 2015 INFO: List of tools directory: apache-maven-3.3.3 bison_3_linux dest-llvm-3.2 dest-mpich-3.0.4 icu4.4 thrift-0.9.0 udis86-1.7.2 zookeeper-3.4.5 |
...