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
This commit is contained in:
lijunbo 2017-12-22 11:21:46 +08:00 committed by Victoria Martinez de la Cruz
parent 7a1414977f
commit c1912b70f6
3 changed files with 56 additions and 1 deletions

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::
/etc/httpd/conf.d/mod_wsgi-manila.conf
On SLES/OpenSUSE it is::
/etc/apache2/vhosts.d/mod_wsgi-manila.conf
On Debian/Ubuntu it is::
/etc/apache2/sites-available/mod_wsgi-manila.conf
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: https://governance.openstack.org/tc/goals/pike/deploy-api-in-wsgi.html#control-plane-api-endpoints-deployment-via-wsgi

View File

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

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"
</IfVersion>
ErrorLog /var/log/apache2/manila_error.log
CustomLog /var/log/apache2/manila.log manila_combined
</VirtualHost>