Browse Source

Merge "Add mod_wsgi configuration samples" into stable/stein

changes/73/747773/1
Zuul 1 month ago
committed by Gerrit Code Review
parent
commit
819bffed1e
3 changed files with 56 additions and 1 deletions
  1. +40
    -0
      doc/source/contributor/apache-httpd.rst
  2. +0
    -1
      doc/source/contributor/index.rst
  3. +16
    -0
      httpd/mod_wsgi-manila.conf

+ 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::

/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

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

@@ -39,7 +39,6 @@ Programming HowTos and Tutorials
user_messages
ganesha


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

</VirtualHost>

Loading…
Cancel
Save