forked from engineyard/vertebra
/
README
91 lines (62 loc) · 2.36 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
== 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.2.0. They are available at:
http://engineyard.github.com/loudmouth-ruby/download/loudmouth-ruby-0.2.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 -- 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.