== Where to get Vertebra
 
The source code is always available via Git:
 
  $ git clone git://github.com/engineyard/vertebra.git
  $ cd vertebra
  $ git submodule init
  $ git submodule update
 
When switching between branches you need to remember to update the
submodules. So to checkout the 0.4.0 tag to a branch you'd do this:
 
  $ git checkout -b v0.4.0 0.4.0
  $ git submodule update
 
Then when you went back to master you'd do this:
 
  $ git checkout master
  $ git submodule update
 
== Dependencies
 
We have provided a script (deps.sh) that installs some dependencies in
/opt/local/vertebra:
 
 * Erlang OTP (R12B-5)
 * ejabberd (2.0.2)
 * erlsom (1.2.1)
 
The script also installs the following gems using the gem command found on your
PATH:
 
 * rspec
 * open4
 * thor
 * rr
 * hoe
 
The following dependencies are not installed:
 
 * expat (most systems have this)
 * gcc (most systems have this, Macs need to install Xcode)
 * iconv (glibc systems have this, only needed for ejabberd mod_irc)
 * make (most systems have this, Macs need to install Xcode)
 * glib (most linux systems have this, needed for loudmouth)
 * loudmouth (see note below)
 * loudmouth-ruby
 * openssl (most systems have this)
 * ruby
 * rubygems
 * wget OR curl (this includes most Macs and Linux machines)
 * zlib (most systems have this)
 
=== Loudmouth
 
The ruby agent library requires the latest versions of both the loudmouth
library and the loudmouth-ruby bindings in order to work properly.
 
As of this writing the latest version of loudmouth is 1.5.0. It is available
at:
 
  http://engineyard.github.com/loudmouth/download/loudmouth-1.5.0.tar.gz
 
Similarly, the latest version of the bindings is 0.3.0. They are available at:
 
  http://engineyard.github.com/loudmouth/download/loudmouth-ruby-0.3.0.tar.gz
 
== Installation
 
If you are installing from git you need to run this command to set up the build
system:
 
  $ autoreconf --install && autoreconf
 
Then to install everything:
 
  $ ./deps.sh -a
  $ ./configure && make && make install
 
What is installed can be broken down into three categories: vertebra libraries,
and vertebra actors.
 
==== Vertebra Libraries
 
 * vertebra-rb -- Core agent library for ruby.
 * vertebra-erl -- Core agent library for erlang and core vertebra services.
 
==== Vertebra Actors
 
 * vertebra-gemtool -- Actor for managing ruby gems.
 * vertebra-xen -- Actor for accessing Xen slice information.