Project

General

Profile

Development and testing with Docker » History » Revision 12

Revision 11 (Tim Pierce, 03/11/2014 05:38 PM) → Revision 12/14 (Tom Clegg, 07/31/2014 03:02 PM)

h1. Installing a Development and testing with Docker Arvados Instance 

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

 http://doc.arvados.org/install/install-docker.html shows how # *Download the Arvados source and switch to install 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 update a development system. 

 h2. Additional sources of information 

 The 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 has more notes. 

 h2. Installing distribution. 
 # *Install the client SDKs.* After following those instructions, install the client libraries 

 on your workstation as well. 
 ## @./install_sdk.sh@ (in the docker directory) will should install all of the CLI tools like arv and arv-put. necessary tools. 
 ## If that 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. 
 <pre> 
 sudo #### @sudo apt-get install curl libcurl3 libcurl3-gnutls libcurl4-openssl-dev python-pip python-pip@ 
 curl #### @curl -sSL https://get.rvm.io | bash -s stable stable@ 
 source ~/.rvm/scripts/rvm #### @source ~/.rvm/scripts/rvm@ 
 rvm #### @rvm install 2.1.0 2.1.0@ 
 </pre> 

 * The ### Install the arvados-cli gem: 
 <pre> 
 gem #### @gem install arvados-cli arvados-cli@ 
 sudo #### @sudo pip install --upgrade httplib2 
 </pre> httplib2@ 

 h2. Tutorials 

 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/ (using your host instead of a shell VM) to upload data into Arvados and run simple Crunch jobs in local development debug mode.