Arvados

h1. Installing a Development Arvados Instance

Arvados is primarily intended as a system to be run on large server clusters.  For developers, we have provided a process to build and deploy the Arvados system in "Docker containers":https://www.docker.io/ on a single machine.

# *Download the Arvados source and switch to the appropriate branch.*

## @git clone git://git.curoverse.com/arvados.git@

## @cd arvados/docker@

## @git checkout 2221-complete-docker@

# *Install the Arvados servers in Docker containers.*

## Install the Docker server. Instructions for downloading and installing Ubuntu packages can be found at http://docs.docker.io/en/latest/installation/ubuntulinux/.

## Run @./build.sh@ to configure and build Arvados in Docker containers.

### More thorough documentation can be found in the "docker/README.md":https://github.com/curoverse/arvados/blob/master/docker/README.md file in the source distribution.

# *Install the client SDKs.* After following those instructions, install the client libraries on your workstation as well.

## @./install_sdk.sh@ should install all of the necessary tools.

## If it does not work for you, try installing these by hand:

### *RVM* -- if you do not already have RVM installed on your workstation, install it now.

#### @sudo apt-get install curl libcurl3 libcurl3-gnutls libcurl4-openssl-dev python-pip@

#### @curl -sSL https://get.rvm.io | bash -s stable@

#### @source ~/.rvm/scripts/rvm@

#### @rvm install 2.1.0@

### Install the arvados-cli gem:

#### @gem install arvados-cli@

#### @sudo pip install --upgrade httplib2@

Once you have installed the servers and started them with @arvdock start@, and installed the client libraries, you should be able to work through the "user tutorials":http://doc.arvados.org/user/ to upload data into Arvados and run simple Crunch jobs in debug mode.