Gulo Development

Developing

Java JDK (1.7.0_67) EC2 API Tools (1.7.1.1) gsutil Git

Gulo runs on the Java 1.7 or later. To develop, you will need to download and install the latest Java SDK and add it to your PATH. Development has been tested with Java JDK 1.7.0_67.

Mac OSX

For example, to develop on Mac OSX, Install JDK from the dmg and pkg therein.

Set up the symlink:

sudo ln -nsf /Library/Java/JavaVirtualMachines/jdk1.7.0_67.jdk/Contents /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK

Set up the environment:

set JAVA_HOME in ~/.bash_profile
export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.7.0_67.jdk/Contents/Home"

We generally run the harvesting workflow on an Ubuntu instance on EC2. Download and install the latest EC2 API tools (tested with version 1.7.1.1.) from http://aws.amazon.com/developertools/351.

For example, on Mac OSX, unzip the contents into ~/dev.

In ~/.bash_profile add:

export EC2_HOME=/Users/myuserdirectory/dev/ec2-api-tools-1.7.1.1
export PATH=$PATH:$EC2_HOME/bin 

In ~/.bashrc add exports for your Amazon Web Services keys in the following format:

export AWS_ACCESS_KEY=[YOUR_ACCESS_KEY_HERE]
export AWS_SECRET_KEY=[YOUR_SECRET_KEY_HERE]

To manage updates to the Github repository, use Git.

Getting started

Make sure you have Git installed, and then from the command line:

$ git clone https://github.com/VertNet/gulo.wiki.git

That will download the full code repository into a directory named gulo.