59 lines
1.7 KiB
ReStructuredText
59 lines
1.7 KiB
ReStructuredText
.. _using-mod-wsgi:
|
|
|
|
Deploying with ``mod_wsgi``
|
|
===========================
|
|
|
|
``mod_wsgi`` makes it possible to run a WSGI_ application (such as OpenERP)
|
|
under the Apache_ HTTP server.
|
|
|
|
.. _WSGI: http://en.wikipedia.org/wiki/Web_Server_Gateway_Interface
|
|
.. _Apache: https://httpd.apache.org/
|
|
|
|
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.
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
In Apache's configuration, add the line
|
|
|
|
::
|
|
|
|
LoadModule wsgi_module modules/mod_wsgi.so
|
|
|
|
to activate ``mod_wsgi``.
|
|
|
|
Then a possible 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
|
|
WSGIProcessGroup oe
|
|
|
|
<Directory /home/thu/repos/server/trunk>
|
|
Order allow,deny
|
|
Allow from all
|
|
</Directory>
|
|
|
|
The ``WSGIScriptAlias`` directive indicates that any URL matching ``/`` will
|
|
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.
|
|
|
|
Finally, it is necessary to make sure the source directory where the script can
|
|
be found is allowed by Apache with the ``Directory`` block.
|
|
|
|
Running
|
|
-------
|
|
|
|
When the Apache configuration changes, it is necessary to restart Apache, e.g. with::
|
|
|
|
/etc/init.d/httpd restart
|