add uWSGI docs

docs/uWSGI.md

@@ -0,0 +1,55 @@
+uWSGI
+=====
+
+In short: [uWSGI](http://uwsgi-docs.readthedocs.org/) is awesome. Isso has
+builtin support for it (and simple fallback if uWSGI is not available). Use
+uWSGI if you think that the builtin WSGI server is a bad choice or slow (hint:
+it's both).
+
+With uWSGI, you have roughly 100% performance improvements for just using it.
+Instead of one thread per request, you can use multiple processes, hence it
+is more "web scale". Other side effects: spooling, fast inter-process caching.
+
+
+Installation
+------------
+
+You need uWSGI 1.9 or higher, fortunately you can install it with Python:
+
+```sh
+~> apt-get install build-essential python-dev
+~> pip install uwsgi
+```
+
+Configuration
+-------------
+
+For convenience, I recommend a INI-style configuration (you can also supply everything
+as command-line arguments):
+
+```ini
+[uwsgi]
+http = :8080
+master = true
+processes = 4
+cache2 = name=hash,items=1024,blocksize=32
+spooler = %d/mail
+module = isso
+virtualenv = %d
+env = ISSO_SETTINGS=%d/sample.cfg
+```
+
+You shoud adjust `processes` to your CPU count. Then, save this file to a directory
+if choice. Next to this file, create an empty directory called `mail`:
+
+```sh
+~> mkdir mail/
+~> ls
+uwsgi.ini  mail/
+```
+
+Now start Isso:
+
+```sh
+~> uwsgi /path/to/uwsgi.ini
+```

isso.ini

@@ -3,7 +3,7 @@ http = :8080
 master = true
 processes = 4
 cache2 = name=hash,items=1024,blocksize=32
-spooler = %v/mail
+spooler = %d/mail
 module = isso
-virtualenv = .
+virtualenv = %d
-env = ISSO_SETTINGS=%v/sample.cfg
+env = ISSO_SETTINGS=%d/sample.cfg