I have religiously followed the documentation found here for installing ceilometer services. I have noticed that the documentation is not correct.

Under the configure the "Apache HTTP Server" section, the documentation suggests to add these entries in the /etc/httpd/conf.d/wsgi-ceilometer.conf file.

Listen 8777

<VirtualHost *:8777>
    WSGIDaemonProcess ceilometer-api processes=2 threads=10 user=ceilometer group=ceilometer display-name=%{GROUP}
    WSGIProcessGroup ceilometer-api
    WSGIScriptAlias / /usr/lib/python2.7/site-packages/ceilometer/api/app.wsgi
    WSGIApplicationGroup %{GLOBAL}
    ErrorLog /var/log/httpd/ceilometer_error.log
    CustomLog /var/log/httpd/ceilometer_access.log combined </VirtualHost>

WSGISocketPrefix /var/run/httpd

However , if you look closely, the ceilometer-api service also listens for requests on 8777 port, thus causing a conflict. In my case, i have changed the port in the wsgi-ceilometer.conf file to 8778. Ans that works ,as expected, properly. This post is not a question, but an attempt to know about how can i point this to the documentation team, so that others dont suffer as i did. Can anyone point me to the links or suggest the steps.