Page History

...

You can find the original Graphite installation instructions here, for the sake of completeness much will be repeated below.

Anchor
download-install download-install

Download Whisper, Carbon and Graphite-web

Clone the GitHub repositories  (use either the 0.9.x [stable] branch or master  [unstable/alpha] branch).

...

> ll /Users/fedora_user/graphite_downloads
total 0
drwxr-xr-x  19 fedora_user  staff  646  5 Sep 12:31 carbon
drwxr-xr-x  23 fedora_user  staff  782  4 Sep 15:37 graphite-web
drwxr-xr-x  10 fedora_user  staff  340  5 Sep 08:58 whisper

Anchor
install-whisper install-whisper

Install whisper

cd whisper
sudo python setup.py install
cd ..

Anchor
install-carbon install-carbon

Install Carbon

cd carbon
sudo python setup.py install
cd ..

This installs to /opt/graphite by default.

Anchor
install-graphite-web install-graphite-web

Install Graphite-web

cd graphite-web
sudo python check-dependencies.py

...

sudo python setup.py install
cd ..

Anchor
configure-graphite configure-graphite

Configure Graphite

cd /opt/graphite/conf
cp carbon.conf.example carbon.conf
cp storage-schemas.conf.example storage-schemas.conf
cp graphite.wsgi.example graphite.wsgi

This setups up a default data retention period of gathering data every second and storing it for 1 day. You can configure this by editing the storage-schemas.conf file.

Anchor
configure-apache configure-apache

Configure Apache

There is an Apache Virtual Hosts file provided in the graphite-web/examples directory. You can use this to configure your Apache installation.

...

1. WSGISocketPrefix run/wsgi

   this needs to be set to a directory that the webserver can write to and can be either a relative or an absolute path.

2. Both the <Location "/content/"> and <Location "/media/"> do not specify access. You may need to add them.

   ie.

   <Location "/content/">
     SetHandler None
   </Location>

   to

   <Location "/content/">
     SetHandler None
     Order deny,allow
     Allow from all
   </Location>
       

Anchor
setup-database setup-database

Setup Database

By default Graphite uses a sqlite3 database, but you can configure it to use a MySQL, Postgresql or Oracle database instead.

...

If you Make sure that the entire storage directory (default /opt/graphite/storage) and all files are owned by the webserver process.

Anchor
start-data-collector start-data-collector

Start Data Collector

cd /opt/graphite/bin/
sudo python carbon-cache.py start
Password:
Starting carbon-cache (instance a)

...

in /opt/graphite/conf/carbon.conf but this will not harm the running process and does not need to be disabled.

Anchor
stronger-security stronger-security

Stronger security

Note: If you are not running the carbon-cache.py daemon as root, then you will need to make the storage directory writable by whichever user you will run carbon-cache.py as.

...

This will allow carbon-cache.py to add new metrics and the web application access to read them.

Anchor
restart-apache restart-apache

Restart Apache

If all is well then browsing to your webserver's homepage should look something like this.

Anchor
connecting-fedora connecting-fedora

Connecting Fedora

To enable Metrics reporting to Graphite, activate the Spring profile metrics.graphite. The system properties fcrepo.metrics.host (defaults to localhost) and fcrepo.metrics.port (defaults to 2003) can also be set.

...