Requirements

• a Java Development Kit (JDK) – Java version 6 or later.
• the ant command line tool – version 1.7 or later.
• the git command line tool  if you want to get the latest source from GitHub.

Getting release sources

1. Go to http://github.com/bixo/bixo/downloads
2. Download the desired bixo-dist-<version>.tgz file.
3. Expand the file into a directory on your computer.

Getting the latest source from GitHub

1. Make sure you have a working git command line client installed

2. % cd <parent directory>

3. % git clone git://github.com/bixo/bixo.git bixo

This will create a directory called bixo in your <parent directory>

Building Bixo

Once you have the source, and a working ant command line tool installed, then you can use the following commands from inside of the bixo directory:

• ant -p (list available build targets)
• ant clean test (clear out build directories, compile, run tests)
• ant jar (build the bixo-core-<version>.jar files)
• ant job (build the bixo-job-<version>.jar file for use with Hadoop)
• ant dist (build a distribution jar, for releases)

Working in Eclipse

To create an Eclipse project:

1. % cd <project root>

2. % ant eclipse

3. From Eclipse, follow standard procedure to import an existing Java project into your Workspace.