From 66202a7778e5870810805d61b8aaf4ffe7ee75f4 Mon Sep 17 00:00:00 2001 From: Anton Arefiev Date: Wed, 29 Jul 2015 15:23:41 +0300 Subject: [PATCH] Add instructions on how to deploy API under Apache Add new documentation with steps how to deploy Cinder API under Apache. Implements: blueprint non-eventlet-wsgi-app Change-Id: I25335991206a2563d266baac6730d130890777db --- doc/source/devref/api.apache.rst | 37 ++++++++++++++++++++++++++++++++ doc/source/devref/index.rst | 1 + 2 files changed, 38 insertions(+) create mode 100644 doc/source/devref/api.apache.rst diff --git a/doc/source/devref/api.apache.rst b/doc/source/devref/api.apache.rst new file mode 100644 index 000000000..e83bae671 --- /dev/null +++ b/doc/source/devref/api.apache.rst @@ -0,0 +1,37 @@ +.. + All Rights Reserved. + + Licensed under the Apache License, Version 2.0 (the "License"); you may + not use this file except in compliance with the License. You may obtain + a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, WITHOUT + WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the + License for the specific language governing permissions and limitations + under the License. + + +Running Cinder API under Apache +=============================== + +Files +----- +Copy the file etc/cinder/api-httpd.conf to the appropriate location for your Apache server, most likely: + +``/etc/httpd/conf.d/cinder_wsgi.conf`` + +Update this file to match your system configuration (for example, some distributions put httpd logs in the apache2 directory and some in the httpd directory). +Create the directory /var/www/cgi-bin/cinder/. You can either hard or soft link the file cinder/wsgi/wsgi.py to be osapi_volume under the /var/www/cgi-bin/cinder/ directory. For a distribution appropriate place, it should probably be copied to: + +``/usr/share/openstack/cinder/httpd/cinder.py`` + +Cinder's primary configuration file (etc/cinder.conf) and the PasteDeploy configuration file (etc/cinder-paste.ini) must be readable to httpd in one of the default locations described in Configuring Cinder. + + +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. \ No newline at end of file diff --git a/doc/source/devref/index.rst b/doc/source/devref/index.rst index 86e64b578..7838f2b7d 100644 --- a/doc/source/devref/index.rst +++ b/doc/source/devref/index.rst @@ -32,6 +32,7 @@ Programming HowTos and Tutorials drivers gmr replication + api.apache Background Concepts for Cinder -- 2.45.2