Installing From Source

The latest source tarballs for Graphite-web, Carbon, and Whisper may be fetched from the Graphite project download page or the latest development branches may be cloned from the Github project page:

  • Graphite-web: git clone https://github.com/graphite-project/graphite-web.git
  • Carbon: git clone https://github.com/graphite-project/carbon.git
  • Whisper: git clone https://github.com/graphite-project/whisper.git
  • Ceres: git clone https://github.com/graphite-project/ceres.git

Note

There currently is no tarball available for Ceres, it must be cloned from the Github project page



Installing in the Default Location

To install Graphite in the default location, /opt/graphite/, simply execute python setup.py installas root in each of the project directories for Graphite-web, Carbon, Whisper, and Ceres.



Installing Carbon in a Custom Location

Carbon’s setup.py installer is configured to use a prefix of /opt/graphite and an install-lib of/opt/graphite/lib. Carbon’s lifecycle wrapper scripts and utilities are installed in bin, configuration within conf, and stored data in storage all within prefix. These may be overridden by passing parameters to the setup.py install command.

The following parameters influence the install location:

  • --prefixLocation to place the bin/ and storage/ and conf/ directories (defaults to /opt/graphite/)
  • --install-libLocation to install Python modules (default: /opt/graphite/lib)
  • --install-dataLocation to place the storage and conf directories (default: value of prefix)
  • --install-scriptsLocation to place the scripts (default: bin/ inside of prefix)

For example, to install everything in /srv/graphite/:



python setup.py install --prefix=/srv/graphite --install-lib=/srv/graphite/lib



To install Carbon into the system-wide site-packages directory with scripts in /usr/bin and storage and configuration in /usr/share/graphite:



python setup.py install --install-scripts=/usr/bin --install-lib=/usr/lib/python2.6/site-packages --install-data=/var/lib/graphite



Installing Graphite-web in a Custom Location

Graphite-web’s setup.py installer is configured to use a prefix of /opt/graphite and aninstall-lib of /opt/graphite/webapp. Utilities are installed in bin, and configuration in confwithin the prefix. These may be overridden by passing parameters to setup.py install

The following parameters influence the install location:

  • --prefixLocation to place the bin/ and conf/ directories (defaults to /opt/graphite/)
  • --install-libLocation to install Python modules (default: /opt/graphite/webapp)
  • --install-dataLocation to place the webapp/content and conf directories (default: value of prefix)
  • --install-scriptsLocation to place scripts (default: bin/ inside of prefix)

For example, to install everything in /srv/graphite/:



python setup.py install --prefix=/srv/graphite --install-lib=/srv/graphite/webapp



To install the Graphite-web code into the system-wide site-packages directory with scripts in/usr/bin and storage configuration, and content in /usr/share/graphite:



python setup.py install --install-scripts=/usr/bin --install-lib=/usr/lib/python2.6/site-packages --install-data=/var/lib/graphite



Next   Previous