Browse Source

Add mod_wsgi configuration samples

Extend docs on running manila API with a web server (Apache, NGINX)
Add samples for mod_wsgi

Partially-implements: blueprint wsgi-web-servers-support

Change-Id: Ic756466e65ffd8b5fc6b8e8fb3eef4b8535b46d6
(cherry picked from commit c1912b70f6)
lijunbo 3 years ago
committed by Goutham Pacha Ravi
3 changed files with 56 additions and 1 deletions
  1. +40
  2. +0
  3. +16

+ 40
- 0
doc/source/contributor/apache-httpd.rst View File

@ -76,4 +76,44 @@ And start the manila server using uwsgi::
In the sample configs port 51999 is used, this is a randomly selected number.
Installing the API via mod_wsgi
The httpd/ directory contains sample files for configuring HTTPD to run manila
API via mod_wsgi. To use sample configs, simply copy `httpd/mod_wsgi-manila.conf` to the
appropiate location for your apache server.
On RHEL/CentOS/Fedora it is::
On SLES/OpenSUSE it is::
On Debian/Ubuntu it is::
On Ubuntu/Debian systems enable the site using the a2ensite tool::
sudo a2ensite /etc/apache2/sites-available/mod_wsgi-manila.conf
This is not required on RHEL/CentOS/Fedora systems.
Start or restart HTTPD/Apache2 to pick up the new configuration.
.. NOTE::
manila's primary configuration file (etc/manila.conf) and the PasteDeploy
configuration file (etc/manila-paste.ini) must be readable to httpd in one
of the default locations described in Configuring Manila.
Access Control
If you are running with Linux kernel security module enabled (for example
SELinux or AppArmor), make sure that the configuration file has the
appropriate context to access the linked file.
.. _community goals for Pike:

+ 0
- 1
doc/source/contributor/index.rst View File

@ -48,7 +48,6 @@ Programming HowTos and Tutorials
Background Concepts for manila
.. toctree::

+ 16
- 0
httpd/mod_wsgi-manila.conf View File

@ -0,0 +1,16 @@
Listen 8786
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" %D(us)" manila_combined
<VirtualHost *:8786>
WSGIDaemonProcess osapi_share processes=2 threads=1 user=manila display-name=%{GROUP}
WSGIProcessGroup osapi_share
WSGIScriptAlias / /var/www/cgi-bin/manila/osapi_share
WSGIApplicationGroup %{GLOBAL}
WSGIPassAuthorization On
<IfVersion >= 2.4>
ErrorLogFormat "%{cu}t %M"
ErrorLog /var/log/apache2/manila_error.log
CustomLog /var/log/apache2/manila.log manila_combined