summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorFei Long Wang <flwang@catalyst.net.nz>2014-08-04 15:22:23 +1200
committerFei Long Wang <flwang@catalyst.net.nz>2014-08-05 10:24:47 +1200
commitf2685fc531cf83539e4d86efef0b306fe304addb (patch)
treed92f456b70a0d14f87db78a54e6f02778df6f9bf /doc
parent0232968509e332b13d952dde3d79b2a20a1acb5d (diff)
downloadceilometer-f2685fc531cf83539e4d86efef0b306fe304addb.tar.gz
Doc enhancement for API service deployment with mod_wsgi
Now Pecan is sharing the same debug configration with Ceilometer, but DebugMiddleware of Pecan doesn't support multi processes. That means user can't enable the Ceilometer debug mode if he is using multi process mode for mod_wsgi config. Closes-Bug: 1352088 Change-Id: I6e83fbcbee23a519fe26c3036f42cc619848a989
Diffstat (limited to 'doc')
-rw-r--r--doc/source/install/mod_wsgi.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/source/install/mod_wsgi.rst b/doc/source/install/mod_wsgi.rst
index e7597931..950978ba 100644
--- a/doc/source/install/mod_wsgi.rst
+++ b/doc/source/install/mod_wsgi.rst
@@ -54,3 +54,16 @@ work with a copy of ceilometer installed via devstack.
$ a2ensite ceilometer
$ service apache2 reload
+
+Limitation
+==========
+
+As Ceilometer is using Pecan and Pecan's DebugMiddleware doesn't support
+multiple processes, there is no way to set debug mode in the multiprocessing
+case. So user will run into HTTP 500 error if the mod_wsgi's multiprocessing
+is enabled and the Ceilometer debug mode is enabled at the same time. There
+is no good way to make both of them work, since Pecan is sharing the debug
+mode with Ceilometer, see[1]. If you really need to enable both, a possible
+workaround is hacking that line and hardcode the debug configration to False.
+
+[1] https://github.com/openstack/ceilometer/blob/master/ceilometer/api/app.py