Permalink
Browse files

updated INSTALL to reference mod_wsgi

  • Loading branch information...
1 parent 63099b6 commit c06d7305f8969ee55d48e7f1e93b191f0cb2435d @cdavis cdavis committed Apr 1, 2011
Showing with 33 additions and 8 deletions.
  1. +33 −8 INSTALL
View
41 INSTALL
@@ -18,7 +18,7 @@ Graphite requires:
pycairo (with PNG backend support)
django
json (standard in python2.6) or simplejson
- mod_python (optional - but highly recommended)
+ mod_wsgi (optional, recommended) or mod_python (optional)
python-ldap (optional - needed for ldap-based webapp authentication)
python-memcached (optional - needed for webapp caching, big performance boost)
python-sqlite2 (optional - a django-supported database module is required)
@@ -67,13 +67,37 @@ The apache user must also have read access to $GRAPHITE_ROOT/storage/whisper/
Apache Configuration
-------------------------------------------------------------------------------
-First off, Apache has to have mod_python configured, this is usually done
-by including a line like the following in your httpd.conf:
+When using apache there are two modules available to provide support for python
+web application.
+
+Graphite currently provides example configurations for both of these modules.
+Of the two mod_wsgi is the most up to date and actively maintained so it's
+highly recommended if you are starting afresh.
+
+ Apache Configuration for Mod_wsgi (recommended)
+-------------------------------------------------------------------------------
+
+If you are using mod_wsgi, Apache has to have mod_wsgi configured,
+this is usually done by including a line like the following in your
+httpd.conf:
+
+LoadModule wsgi_module modules/mod_wsgi.so
+
+ Apache Configuration for Mod_python
+-------------------------------------------------------------------------------
+
+If you choose to use mod_python, Apache has to have mod_python configured,
+this is usually done by including a line like the following in your
+httpd.conf:
LoadModule python_module modules/mod_python.so
-Second you should configure a vhost for graphite (technically it doesn't have
-to be a vhost but its good practice). This can be done one of two ways.
+ General Apache Configuration
+-------------------------------------------------------------------------------
+
+Once you have configured the apache module you are using you should configure
+a vhost for graphite (technically it doesn't have to be a vhost but its good
+practice). This can be done one of two ways.
The first way (highly preferred) is to include independent vhost configs.
@@ -82,10 +106,11 @@ Include /usr/local/apache2/conf/vhosts.d/*.conf
Then simply drop your graphite vhost conf file into the vhosts.d/ directory
(or whatever directory your system uses) and apache is ready. You can use
-the examples/example-graphite-vhost.conf file included in this package as a
-starting point.
+either of the example vhost confs as a starting point (See the examples
+directory of this package and choose the correct one based on whether you
+are using mod_wsgi or mod_python.)
-The second approach is to copy the contents of the graphite vhost conf file
+The second approach is to copy the contents of your chosen graphite vhost conf file
and insert it down at the end of your httpd.conf.

0 comments on commit c06d730

Please sign in to comment.