Browse Source

Merge "Add mod_wsgi configuration samples" into stable/stein

Zuul 1 month ago
committed by Gerrit Code Review
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

@@ -39,7 +39,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