odoo
/
odoo
2
0
Fork 0
Code Pull Requests Releases Activity

[DOC] mod_wsgi: slight improvement. 

bzr revid: vmt@openerp.com-20130206103835-dsd4mrq8ya4fkz52
This commit is contained in:
Vo Minh Thu 2013-02-06 11:38:35 +01:00
parent 22a612ee28
commit f609cce671
1 changed files with 27 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/deployment-mod-wsgi.rst
View File

@ -13,23 +13,32 @@ Summary
------- -------
Similarly to :doc:`deployment-gunicorn`, running OpenERP behind Apache with Similarly to :doc:`deployment-gunicorn`, running OpenERP behind Apache with
``mod_wsgi`` requires to modify the sample ``openerp-wsgi.py`` script. ``mod_wsgi`` requires to modify the sample ``openerp-wsgi.py`` script. Then
For instance, make sure to correctly set the ``addons_path`` configuration that Python script can be set in the Apache configuration.
(using absolute paths). 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.
Apache Configuration
--------------------
In Apache's configuration, add the following line to activate ``mod_wsgi``::
LoadModule wsgi_module modules/mod_wsgi.so LoadModule wsgi_module modules/mod_wsgi.so
to activate ``mod_wsgi``. Then a possible (straightforward, with e.g. no virtual server) configuration is
as follow::
Then a possible configuration is as follow::
WSGIScriptAlias / /home/thu/repos/server/trunk/openerp-wsgi.py 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 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 The ``WSGIDaemonProcess`` and ``WSGIProcessGroup`` directives create a process
configuration. The configuration makes it possible for isntance to specify 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 Finally, it is necessary to make sure the source directory where the script can
be found is allowed by Apache with the ``Directory`` block. 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 Running
------- -------