Installation guide - Improve ceilometer content

[Matt Kassawara]

I tested installation of the Juno release of ceilometer, particularly the controller and compute components on Ubuntu 14.04 and Fedora 20, and came up with the following content improvements:

General
======

Controller
===

Add example output from DB creation:

MongoDB shell version: 2.4.9
connecting to: hst-os3ctl1:27017/test
{
 "user" : "ceilometer",
 "pwd" : "72f25aeee7ad4be52437d7cd3fc60f6f",
 "roles" : [
  "readWrite",
  "dbAdmin"
 ],
 "_id" : ObjectId("5489c22270d7fad1ba631dc3")
}

In the /etc/ceilometer/ceilometer.conf file:

Add '[DEFAULT] verbose = true' option including note about enabling verbose output

Compute
===

Install and configure ceilometer before compute

In the /etc/ceilometer/ceilometer.conf file:

Add '[DEFAULT] verbose = true' option including note about enabling verbose output

Add '[DEFAULT] rpc_backend = rabbit' option

Add '[service_credentials] os_region_name = regionOne' option

Image Service
===

In the /etc/glance/glance-registry.conf file:

Add '[DEFAULT] notification_driver = messaging' option

Add '[DEFAULT] rpc_backend = rabbit' option

Add '[DEFAULT] rabbit_host = controller' option

Add '[DEFAULT] rabbit_password = RABBIT_PASS' option

Verify
===

Consider updating example output and a note that some meters might not appear until successful launch of at least one instance.

Ubuntu 14.04
======

Controller
===

Add mongodb-clients and python-pymongo packages

In the /etc/ceilometer/ceilometer.conf file:

Remove explicit configuration of 'log_dir' option

Compute
===

In the /etc/ceilometer/ceilometer.conf file:

Remove explicit configuration of 'log_dir' option

Image Service
===

RHEL/CentOS/Fedora
======

Controller
===

Change MongoDB init scripts to use systemd commands

systemctl enable mongod.service
systemctl start mongod.service

In the /etc/ceilometer/ceilometer.conf file:

Add note: MongoDB connection string requires escaping special characters as per RFC2396

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/147574
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=f6268ba315ae708b3c30ea6b1189ec9b31159f54
Submitter: Jenkins
Branch: master

commit f6268ba315ae708b3c30ea6b1189ec9b31159f54
Author: Dhriti Shikhar <email address hidden>
Date: Thu Jan 15 18:48:11 2015 +0530

    Improved ceilometer content

    Closes-bug: #1405252
    Co-Authored-By: Matt Kassawara <email address hidden>
    backport: juno

    Change-Id: Iccbea43eea85ad78910f86c81d7f32383c5d4440

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/juno
Review: https://review.openstack.org/152626

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/152957

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/152626
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=749e729f511ffccd03213832eacb4dcde262172b
Submitter: Jenkins
Branch: stable/juno

commit 749e729f511ffccd03213832eacb4dcde262172b
Author: Dhriti Shikhar <email address hidden>
Date: Thu Jan 15 18:48:11 2015 +0530

    Improved ceilometer content

    Closes-bug: #1405252
    Co-Authored-By: Matt Kassawara <email address hidden>
    backport: juno

    Change-Id: Iccbea43eea85ad78910f86c81d7f32383c5d4440
    (cherry picked from commit f6268ba315ae708b3c30ea6b1189ec9b31159f54)

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/152957
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=776e5c46bf97a5b5647a8b50c416f11085ee5007
Submitter: Jenkins
Branch: master

commit 776e5c46bf97a5b5647a8b50c416f11085ee5007
Author: Matthew Kassawara <email address hidden>
Date: Wed Feb 4 09:38:24 2015 -0600

    Improve ceilometer content

    Address comments from the backport of patch #152626.

    Change-Id: Ie37a18e500e17b6cf0f6dc7fdcc5a6630b4be341
    Closes-Bug: #1405252
    backport: juno

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.