openstack/deb-ceilometer
Code Issues Proposed changes
9e5b690502
deb-ceilometer/doc/source/install/mod_wsgi.rst
Chris Dent 8691ba8086 Allow pecan debug middleware to be turned off 
The Pecan DebugMiddleware is turned on or off based on the
ceilometer.conf-wide debug setting. This is not useful for situations
where running ceilometer-api under mod_wsgi with multiple processes
is desired.

This change adds a pecan_debug setting to the api section of config,
defaulting to the DEFAULT debug value. mod_wsgi install docs updated
accordingly.

Configuration docs have not yet been udpated. They will be pending a
fix to bug 1370030

Closes-Bug: #1370009

Change-Id: Ib4a472e3c8d1f34f64a5f3ab993c1211dee8af9a
2014-09-17 10:06:43 +01:00

2.2 KiB
Raw Blame History

Installing the API Behind mod_wsgi

Ceilometer comes with a few example files for configuring the API service to run behind Apache with mod_wsgi.

app.wsgi

The file ceilometer/api/app.wsgi sets up the V2 API WSGI application. The file is installed with the rest of the ceilometer application code, and should not need to be modified.

etc/apache2/ceilometer

The etc/apache2/ceilometer file contains example settings that work with a copy of ceilometer installed via devstack.

../../../etc/apache2/ceilometer

  1. Copy or symlink the file to /etc/apache2/sites-avilable.

  2. Modify the VirtualHost directive, setting a hostname or IP for the service. The default settings assume that the ceilometer API is the only service running on the local Apache instance, which conflicts with Horizon's default configuration.

  3. Modify the WSGIDaemonProcess directive to set the user and group values to a user available on your server.

  4. Modify the APACHE_RUN_USER and APACHE_RUN_GROUP values to the name of a user and group available on your server.

  5. Enable the ceilometer site.

    $ 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. To allow multiple processes the DebugMiddleware may be turned off by setting pecan_debug to False in the api section of ceilometer.conf.