[DOC] mod_wsgi: slight improvement.

bzr revid: vmt@openerp.com-20130206103835-dsd4mrq8ya4fkz52

diff --git a/doc/deployment-mod-wsgi.rst b/doc/deployment-mod-wsgi.rst
index 82b1a50..f280946 100644 (file)
--- a/doc/deployment-mod-wsgi.rst
+++ b/doc/deployment-mod-wsgi.rst
@@ -13,23 +13,32 @@ Summary
 -------
 
 Similarly to :doc:`deployment-gunicorn`, running OpenERP behind Apache with
-``mod_wsgi`` requires to modify the sample ``openerp-wsgi.py`` script.
-For instance, make sure to correctly set the ``addons_path`` configuration
-(using absolute paths). Then that Python script can be set in the Apache
-configuration.
+``mod_wsgi`` requires to modify the sample ``openerp-wsgi.py`` script. Then
+that Python script can be set in the Apache configuration.
 
-Configuration
--------------
+Python (WSGI) application
+-------------------------
 
-In Apache's configuration, add the line
+Apache needs a Python script providing the WSGI application. By default the
+symbol looked up by Apache is ``application`` but it can be overidden with the
+``WSGICallableObject`` directive if necessary. A sample script
+``openerp-wsgi.py`` is provided with OpenERP and you can adapt it to your
+needs. For instance, make sure to correctly set the ``addons_path``
+configuration (using absolute paths).
 
-::
+.. note ::
+  The script provided to Apache has often the extension ``.wsgi`` but the
+  ``openerp-wsgi.py`` script will do just as fine.
 
-  LoadModule wsgi_module modules/mod_wsgi.so
+Apache Configuration
+--------------------
+
+In Apache's configuration, add the following line to activate ``mod_wsgi``::
 
-to activate ``mod_wsgi``.
+  LoadModule wsgi_module modules/mod_wsgi.so
 
-Then a possible configuration is as follow::
+Then a possible (straightforward, with e.g. no virtual server) configuration is
+as follow::
 
   WSGIScriptAlias / /home/thu/repos/server/trunk/openerp-wsgi.py
   WSGIDaemonProcess oe user=thu group=users processes=2 python-path=/home/thu/repos/server/trunk/ display-name=apache-openerp
@@ -45,11 +54,17 @@ run the application defined in the ``openerp-wsgi.py`` script.
 
 The ``WSGIDaemonProcess`` and ``WSGIProcessGroup`` directives create a process
 configuration. The configuration makes it possible for isntance to specify
-which user runs the OpenERP process.
+which user runs the OpenERP process. The ``display-name`` option will make the
+processes appear as ``apache-openerp`` in ``ps`` (instead of the normal
+``httpd``).
 
 Finally, it is necessary to make sure the source directory where the script can
 be found is allowed by Apache with the ``Directory`` block.
 
+``mod_wsgi`` supports a lot of directives, please see this ``mod_wsgi`` wiki
+page for more details:
+http://code.google.com/p/modwsgi/wiki/ConfigurationDirectives.
+
 Running
 -------