8229941dcf
This adds a new notification driver to be used by nova in order to intercept instance deletion message before the instance is deleted. With this, we are able to poll an instance about to be deleted before it disappers and therefore not miss any meter. This fixes bug #1005944 Change-Id: Ie039681e8e440cb9be2f30e3d72d9a2bc4ddf5ba Signed-off-by: Julien Danjou <julien@danjou.info>
76 lines
2.5 KiB
ReStructuredText
76 lines
2.5 KiB
ReStructuredText
..
|
|
Copyright 2012 Nicolas Barcet for Canonical
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
not use this file except in compliance with the License. You may obtain
|
|
a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
License for the specific language governing permissions and limitations
|
|
under the License.
|
|
|
|
.. _install:
|
|
|
|
================================================
|
|
Installing and Running the Development Version
|
|
================================================
|
|
|
|
Ceilometer has four daemons. The :term:`compute agent` runs on the
|
|
Nova compute node(s) while the :term:`central agent` and
|
|
:term:`collector` run on the cloud's management node(s). In a
|
|
development environment created by devstack_, these two are typically
|
|
the same server. They do not have to be, though, so some of the
|
|
instructions below are duplicated. Skip the steps you have already
|
|
done.
|
|
|
|
.. _devstack: http://www.devstack.org/
|
|
|
|
Configuring Devstack
|
|
====================
|
|
|
|
.. index::
|
|
double: installing; devstack
|
|
|
|
1. Create a ``localrc`` file as input to devstack.
|
|
|
|
2. Ceilometer makes extensive use of the messaging bus, but has not
|
|
yet been tested with ZeroMQ. We recommend using Rabbit or qpid for
|
|
now.
|
|
|
|
3. Nova does not generate the periodic notifications for all known
|
|
instances by default. To enable these auditing events, set
|
|
``instance_usage_audit`` to true in the nova configuration file.
|
|
|
|
4. The ceilometer services are not enabled by default, so they must be
|
|
enabled in ``localrc`` before running ``stack.sh``.
|
|
|
|
This example ``localrc`` file shows all of the settings required for
|
|
ceilometer::
|
|
|
|
# Configure the notifier to talk to the message queue
|
|
# and turn on usage audit events
|
|
EXTRA_OPTS=(notification_driver=nova.openstack.common.notifier.rabbit_notifier,ceilometer.compute.nova_notifier)
|
|
|
|
# Enable the ceilometer services
|
|
enable_service ceilometer-acompute,ceilometer-acentral,ceilometer-collector
|
|
|
|
Running the API Server
|
|
======================
|
|
|
|
.. index::
|
|
double: installing; API
|
|
|
|
::
|
|
|
|
$ ceilometer-api
|
|
|
|
.. note::
|
|
|
|
The development version of the API server logs to stderr, so you
|
|
may want to run this step using a screen session or other tool for
|
|
maintaining a long-running program in the background.
|