rmoff/Getting Graphiti working on Ubuntu 12.10.md

## Getting Graphiti working on Ubuntu 12.10.md

      
    Raw
  

              Getting Graphiti working on Ubuntu 12.10.md
            
          
    Getting Graphiti working on Ubuntu 12.10

https://github.com/paperlesspost/graphiti
Caveat

I know nothing about Ruby etc, so the below was done with sheer ignorance, brute force and Google.
Pre-requisites not covered here

A functioning installation of Graphite
Redis (can run on a separate server if needed)

wget http://redis.googlecode.com/files/redis-2.6.10.tar.gz
tar xzf redis-2.6.10.tar.gz
cd redis-2.6.10
make
./src/redis-server

Install Ruby with RVM

\curl -L https://get.rvm.io | bash -s stable --ruby

(This can take a while to run)
Run:
source ~/.rvm/scripts/rvm
rvm use ruby-2.0.0

rvm pkg install zlib --verify-downloads 1
rvm pkg install openssl

gem install bundler unicorn

For info:
$ rvm list
	
	rvm rubies
	
	=> ruby-2.0.0-p0 [ x86_64 ]	

Install Graphiti

Install git and some other bits:
sudo apt-get install -y git build-essential g++

Clone Graphiti repo:
git clone https://github.com/paperlesspost/graphiti.git
cd graphiti/
cp config/settings.yml.example config/settings.yml

Frig the Gemfile, comment out   gem 'ruby-debug19' in Gemfile.

If you don't, there's a build error on the gem using ruby 2.0.0.
Now run the install:
gem install linecache19 -v '0.5.12' -- --with-ruby-include=/home/rmoff/.rvm/src/ruby-2.0.0-p0/
bundle install

The seperate gem install of linecache19 is necessary to avoid
[...]
/home/rmoff/.rvm/rubies/ruby-2.0.0-p0/lib/ruby/gems/2.0.0/gems/ruby_core_source-0.1.5/lib/contrib/uri_ext.rb:268:in `block (2 levels) in read': Looking for http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-2.0.0-p0.tar.gz and all I got was a 404! (URI::NotFoundError)
[...]

Unicorn

Unicorn is a HTTP server, through which Graphiti can be accessed.
Install unicorn:
gem install unicorn

Set up some folders and permissions that are required
sudo mkdir -p  /var/sites/graphiti/shared/pids/
sudo mkdir -p  /var/sites/graphiti/shared/log/
sudo chmod -R 777 /var/sites

Set up graphiti in unicorn
bundle exec unicorn -c config/unicorn.rb -E production -D

Folders and permissions are required to resolve:
/home/rmoff/.rvm/gems/ruby-2.0.0-p0/gems/unicorn-4.3.1/lib/unicorn/configurator.rb:90:in `block in reload': directory for pid=/var/sites/graphiti/shared/pids/unicorn.pid not writable (ArgumentError)

Populate redis with list of metrics from graphite


Before you run this, make sure your redis is running and you've updated graphiti's config/settings.yml


if necessary to update the redis server (the :6379:1/graphiti bit is standard, just update the hostname)
 redis_url: my-redis-server:6379:1/graphiti


For the graphite server and graphiti server
 graphiti_base_url: http://my-graphiti-server
 graphite_base_url: http://my-graphite-server


Make sure the metrics prefix is set correctly for the metrics that you have. If you want to see all metrics, set it to blank
 metric_prefix: ""


Install libcurl:
  sudo apt-get install -y libcurl4-openssl-dev

libcurl4-openssl-dev is necessary to resolve:
  rake aborted!
  Could not open library 'libcurl': libcurl: cannot open shared object file: No such file or directory.
  Could not open library 'libcurl.so': libcurl.so: cannot open shared object file: No such file or directory


Run the metrics get:
  cd ~/graphiti
  bundle exec rake graphiti:metrics

You should get something like this:
  $ bundle exec rake graphiti:metrics
  The source :rubygems is deprecated because HTTP requests are insecure.
  Please change your source to 'https://rubygems.org' if possible, or 'http://rubygems.org' if not.
  Getting http://my-graphite-server/metrics/index.json
  Got 1960 metrics

This will need rerunning whenever you add new metrics into carbon


Go!

Run unicorn:
unicorn

It should bind to port 8080
$ unicorn
I, [2013-02-26T18:29:29.652092 #9031]  INFO -- : listening on addr=0.0.0.0:8080 fd=11
I, [2013-02-26T18:29:29.652271 #9031]  INFO -- : worker=0 spawning...
I, [2013-02-26T18:29:29.653406 #9031]  INFO -- : master process ready
I, [2013-02-26T18:29:29.653914 #9033]  INFO -- : worker=0 spawned pid=9033
I, [2013-02-26T18:29:29.654079 #9033]  INFO -- : Refreshing Gem list
I, [2013-02-26T18:29:30.364918 #9033]  INFO -- : worker=0 ready

You should be able to access graphiti now on http://server:8080/
Starting back up after a reboot

rvm use ruby-2.0.0
cd ~/graphiti
unicorn

[Optional] Alternative to unicorn : Getting it working in Apache with Passenger

This wasn't done under RVM but an apt-get installed ruby. It almost certainly won't work unmodified work with the above instructions
sudo apt-get install -y libcurl4-openssl-dev apache2-prefork-dev libapr1-dev libaprutil1-dev 
sudo gem install passenger
sudo passenger-install-apache2-module

Create /etc/apache2/mods-enabled/passenger.load
LoadModule passenger_module /var/lib/gems/1.9.1/gems/passenger-3.0.19/ext/apache2/mod_passenger.so
PassengerRoot /var/lib/gems/1.9.1/gems/passenger-3.0.19
PassengerRuby /usr/bin/ruby1.9.1

Create /etc/apache2/sites-enabled/001-graphiti
<VirtualHost *:81>
   ServerName localhost
   # !!! Be sure to point DocumentRoot to 'public'!
   DocumentRoot /home/rmoff/graphiti/public
   <Directory /home/rmoff/graphiti/public>
      # This relaxes Apache security settings.
      AllowOverride all
      # MultiViews must be turned off.
      Options -MultiViews
   </Directory>
</VirtualHost>

Restart apache2
sudo service apache2 restart   

Graphiti should be available on http://localhost:81/