fabric-graphite is a fabric script to install Graphite, Nginx, uwsgi and all dependencies on a debian-based host.
I was reading a few interesting posts about graphite. When I tried to install it however, I couldn't find anything that really covered all the steps. Some covered it well for Apache, others covered Nginx, but had steps missing or assumed the reader knows about them etc.
I'm a big fan of fabric, and try to do all deployments and installations using it. This way I can re-run the process, and also better document what needs to be done. So instead of writing another guide, I created this fabric script.
- Workstation running python (version 2.7 recommended). All platforms should be supported.
- Fabric - can be installed via
pip install fabric
oreasy_install fabric
- a new VPS/Dedicated server running a Debian-based distribution (Debian, Ubuntu etc)
Best to execute this on a clean virtual machine running Debian 6 (Squeeze). Also tested successfully on Ubuntu 12.04 VPS.
run fab graphite_install -H root@{hostname}
(hostname should be the name of a virtual server you're installing onto)
It might prompt you for the root password on the host you are trying to instal onto.
You can use it with a user other than root, as long as this user can sudo
.
During the installation, you would be asked to set up the django superuser account. You might want to create an account,
but it's not strictly necessary. If you answer no
, the installation will still work fine.
Simply open your browser and go to http://[your-hostname]/graphite/
! It should be up and running.
Of course there's a lot more configuration to be done, but at the very least you should have a working environment to play with Graphite.
Thanks to the authors of these online guides and resources who provided very useful information that I stitched together into this fabric script, and others who provided inspiration about Graphite in General:
- Graphite Docs
- frl1nuX - Graphite and Nginx
- Agile Testing - Installing and configuring Graphite
- Corey Goldberg - Installing Graphite 0.9.9 on Ubuntu 12.04 LTS
- Tom Purl - Installing Graphite on Ubuntu 10.4 LTS
Although not installed with this fabric script, I'd love to try these some time:
Please try this at your own risk. Please run this only with a newly installed host that you can easily throw away! I tested it with both Debian 6 and Ubuntu 12.04 successfully. However, you may experience different results.
I'd be happy to try to help if I can, but given the complexity of linux-based operating-systems, and my limited time, I might not be able to know why a certain operation fails or an error is generated. Feel free to fork for your own special requirements or needs.