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)

doc/source/contributor/apache-httpd.rst

@@ -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

doc/source/contributor/index.rst

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

httpd/mod_wsgi-manila.conf

@@ -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>