THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
This page describes the tools that need to be manually downloaded, built and installed on a system used to build Trafodion.
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 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.
Several tools need to be downloaded, built, and installed. They include:
- MPICH – This tools in an : 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 – This tools is a general: General-purpose parser generator.
- Udis86 – this tool is a minimalistic : Minimalistic disassembler library (libudis86) for the x86 class of instruction set architectures.
- LLVM is a collection : Collection of modular and reusable compiler and toolchain technologies.
- ICU is a setup : Setup of C/C++ and Java libraries providing Unicode and Globalization support for software applications.
- Zookeeper – is a coordination : Coordination service for distributed applications. It exposes common services such as naming, configuration management, synchronization, and group services.
- Thrift – is a communications : 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:
- 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
To install each tool individually, go to "Install tools manually"
...
| Note |
|---|
You may want to modify |
traf_tools_setup.sh |
...
for |
...
your specific environment. Example: if you already have Zoopkeeper installed, you may not want to re-install it. You may need root or |
...
sudo access to |
...
installs the tools in desired |
...
locations. In the sections below, |
...
incubator-trafodion represents the root directory where you installed the Trafodion source |
...
. |
...
(If you have not yet downloaded Trafodion source, please do |
...
so now. |
...
) |
cd <Trafodion download directory>
cd apache-trafodion-1.3.0-incubating/install
...
| Code Block | |||
|---|---|---|---|
|
|
...
|
...
| |
cd incubator-trafodion.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 |
Execute 'Run traf_tools_setup.sh' to to install all dependent tools. Note:
| Note |
|---|
Don' |
...
...
later. |
Manual Install
...
In the sections below, the <tool the <tool installation directory> is the directory where you want the tool to be installed.
...
Trafodion has been built and tested with version 3.0.4 of MPICH. The source tar file can be downloaded from http://www.mpich.org/static/downloads/3.0.4/mpich-3.0.4.tar.gz (http://www.mpich.org/downloads). Save the mpich-3.0.4.tar.gz file to your build system and then perform the following commands.
| Code Block | ||
|---|---|---|
| ||
tar -xzf mpich-3.0.4.tar.gz
cd mpich-3.0.4
./configure --prefix=<tool installation directory>/dest-mpich-3.0.4 --with-device=ch3:sock --disable-f77 --disable-fc
make
make check
make install |
...
| Note |
|---|
|
...
<tool installation directory> is the directory where you want MPICH to be installed. If you do not specify the --prefix option, the default location is /usr/local. For more detailed instructions, see the README file that comes with the source. |
Bison
Trafodion has been built and tested with version 3.0. To Use the following command tTo determine if Bison is installed and is compatible:
which bison
...
| Code Block | ||
|---|---|---|
| ||
which bison bison --version |
...
If a version older than 3.0 is returned, please download a later version. The source tar file can be downloaded from http://ftp.gnu.org/gnu/bison/bison-3.0.tar.gz (http://ftp.gnu.org/gnu/bison/). Save the bison-3.0.tar.gz file to your build system and then perform the following commands. :
| Code Block | ||
|---|---|---|
| ||
tar -xzf bison-3.0.tar.gz
cd bison-3.0
./configure --prefix=<tool installation directory>/bison_3_linux
make
make check
make install |
...
| Note |
|---|
The make check |
...
step may return errors like the following that can be ignored: make[3]: Entering directory `<mydir>/bison-3.0' YACC examples/calc++/calc++-parser.stamp CXX examples/calc++/examples_calc___calc__-calc++-driver.o LEX examples/calc++/calc++-scanner.cc CXX examples/calc++/examples_calc___calc__-calc++-scanner.o g++: ./examples/calc++/calc++-scanner.cc: No such file or directory g++: no input file |
Adjust your PATH if necessary to make sure the correct version is chosen:
which bison
bison – version
.
| Code Block | ||
|---|---|---|
| ||
which bison
bison --version |
Refer to the bison INSTALL file for detailed instructions. Note: For more detailed instructions, see the INSTALL file that comes with the source.
Udis86
Trafodion has been built and tested with version 1.7.2. The source tar file can be downloaded from http://sourceforge.net/projects/udis86/files/udis86/1.7/udis86-1.7.2.tar.gz (http://udis86.sourceforge.net). Udis86 is a prerequisite to building the LLVM product.
...