Project

General

Profile

Development and testing with Docker » History » Revision 11

Revision 10 (Tim Pierce, 03/11/2014 05:37 PM) → Revision 11/14 (Tim Pierce, 03/11/2014 05:38 PM)

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 Download the Arvados source and switch to the appropriate branch.* 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.