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
This commit is contained in:
Fei Long Wang 2014-08-04 15:22:23 +12:00
parent 0232968509
commit f2685fc531

View File

@ -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