Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Excerpt
hiddentrue

Describes how to download and install the Trafodion source using git, tar files, and zip files.


You can obtain the Trafodion source code using one of these methods:

Anchor
download-install-git-fork
download-install-git-fork

Git Fork

If you intend to make changes to the Trafodion source tree, then install the source tree from GitHub.

Install Git Tools

If you haven’t done so already, install the Git Tools:

 

Download Trafodion Source Tree

You download the Trafodion source tree once the git tools have been installed.

Fork Trafodion Repository

You create a private fork of Trafodion on https://github.com/apache/incubator-trafodion. Use the fork button top-right on the page to create your fork, which will be named <your-gitgithub-id>_fork.

The following examples use trafdeveloper to represent <your-gitgithub-id>.

 

Clone Trafodion Repository

Use the git shell to perform this task.


Code Block
languagebashthemeConfluence
titleClone Trafodion Repository
# Move to the directory where you want to install the Trafodion source code.
cd mysource

# Clone the Trafodion source code
git clone git://git.apache.org/incubator-trafodion.git
 
# Change to the Trafodion source-tree directory
cd trafodion

# Register your fork as a remote branch
git remote add trafdeveloper_fork git@github.com:trafdeveloper/incubator-trafodion

 

Create Task Branch

You create a task branch to make changes to the Trafodion source tree. Typically, we name the branches after the Jira we are working on. In this example, the Jira is: TRAFODION-1507.

Code Block
languagebash
themeEmacs
titleCreate Task Branch
collapsetrue
# Ensure that you have the latest changes
git fetch --all

# Checkout source
git checkout -b TRAFODION-1507 origin/master

Anchor
tar_zip
tar_zip
tar/zip Download

Typically, you download the Trafodion source tree as a tar/zip file if you don’t intend the change the source code. For example, when you want to build the Trafodion binaries only.

 

tar file


Download Locationhttps://dist.apache.org/repos/dist/release/incubatortrafodion/trafodion

  1. Open the trafodion folder.

    Info
    titlePGP Key

    The source tar file has been signed with one of the pgp key A44C5A05keys, which is included in the download location’s KEYS folderfile.


  2. Open the folder containing the version you want to download. For example: apache-trafodion-1.3.0-incubating

  3. Download the -src file that fits your security needs. For example: apache-trafodion-1.3.0-incubating-src.tar.gz

  4. Unpack the tar file:

    Code Block
    languagebash
    themeEmacs
    collapsetrue
    mkdir <target-directory>
    tar -xzf <tar file> -C <target-directory>
    # Change direcotry name to match GitHub download name; makes this guide simpler to write.
    mv <target-directory>/apache-trafodion-<version>-incubating <target-directory>/incubator-trafodion

    Example

    Code Block
    collapse
    languagebash
    themeEmacs
    true
    $ mkdir ~/mysource
    $ tar -xzf apache-trafodion-1.3.0-incubating-src.tar.gz -C ~/mysource
    $ ls mysource
    apache-trafodion-1.3.0-incubating
    $ ls mysource/apache-trafodion-1.3.0-incubating
    core  DISCLAIMER.txt  env.sh   licenses     Makefile    pom.xml         README.txt  win-odbc64
    dcs   docs            install  LICENSE.txt  NOTICE.txt  RAT_README.txt  tests       wms
    $ # Change directory name to match GitHub download name; makes this guide simpler to write.
    $ mv mysource/apache-trafodion-1.3.0-incubating mysource/incubator-trafodion
    $ ls mysource
    incubator-trafodion


zip File

Click on Download ZIP at https://github.com/apache/trafodion. The zip file will be named trafodion-master.zip.

 

 
  1. If necessary, FTP the zip file to your Linux development environment using WinSCP or a similar tool.
  2. Unzip to the target directory.

    Code Block
    languagebash
    titleUnzip Trafodion Source
    unzip -q trafodion-master.zip -d mysource

    Example

     

    Code Block
    languagebash
    titleUnzip Example
    $ unzip -q trafodion-master.zip -d mysource
    $ ls mysource
    trafodion-master
    $ ls mysource/trafodion-master
    core  DISCLAIMER.txt  env.sh   licenses     Makefile    pom.xml         README.txt  win-odbc64
    dcs   docs            install  LICENSE.txt  NOTICE.txt  RAT_README.txt  tests       wms
    $ # Change directory name to match GitHub download name; makes this guide simpler to write.
    $ mv mysource/trafodion-master mysource/trafodion
    $ ls mysource
    trafodion