From f2685fc531cf83539e4d86efef0b306fe304addb Mon Sep 17 00:00:00 2001 From: Fei Long Wang Date: Mon, 4 Aug 2014 15:22:23 +1200 Subject: [PATCH] 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 --- doc/source/install/mod_wsgi.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/source/install/mod_wsgi.rst b/doc/source/install/mod_wsgi.rst index e75979317..950978ba0 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