Files

Doug Hellmann 2eebd4a8bd Skeleton for API server

This changeset introduces a framework for the API service,
including the dependency list, a couple of simple API methods,
a test suite, and documentation for starting the development
server.

Change-Id: I4a496c600b7e6a0a8c70113b1d099614febd899d
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>

2012-07-27 10:34:36 -04:00

5.2 KiB

Raw Blame History

Installing and Running the Development Version

Ceilometer has three daemons. The agent runs on the Nova compute node(s). The collector and API server 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.

Installing the Collector

double: installing; collector

Install and configure nova.

The collector daemon imports code from nova, so it needs to be run on a server where nova has already been installed.

Note

Ceilometer makes extensive use of the messaging bus, but has not yet been tested with ZeroMQ. We recommend using Rabbit or qpid for now.
Install MongoDB.

Follow the instructions to install the MongoDB package for your operating system, then start the service.

Clone the ceilometer git repository to the management server:

$ cd /opt/stack
$ git clone https://github.com/stackforge/ceilometer.git

As a user with root permissions or sudo privileges, run the ceilometer installer:
```
$ cd ceilometer
$ sudo python setup.py install
```
Configure ceilometer.

Ceilometer needs to know about some of the nova configuration options, so the simplest way to start is copying /etc/nova/nova.conf to /etc/ceilometer-collector.conf. Some of the logging settings used in nova break ceilometer, so they need to be removed. For example, as a user with root permissions:
```
$ grep -v format_string /etc/nova/nova.conf > /etc/ceilometer-collector.conf
```
Refer to configuration for details about any other options you might want to modify before starting the service.
Start the collector.
```
$ ./bin/ceilometer-collector
```
Note

The default development configuration of the collector 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.

Installing the Compute Agent

double: installing; compute agent

Note

The compute agent must be installed on each nova compute node.

Install and configure nova.

The collector daemon imports code from nova, so it needs to be run on a server where nova has already been installed.

Note

Ceilometer makes extensive use of the messaging bus, but has not yet been tested with ZeroMQ. We recommend using Rabbit or qpid for now.

Clone the ceilometer git repository to the server:

$ cd /opt/stack
$ git clone https://github.com/stackforge/ceilometer.git

As a user with root permissions or sudo privileges, run the ceilometer installer:
```
$ cd ceilometer
$ sudo python setup.py install
```
Configure ceilometer.

Ceilometer needs to know about some of the nova configuration options, so the simplest way to start is copying /etc/nova/nova.conf to /etc/ceilometer-agent.conf. Some of the logging settings used in nova break ceilometer, so they need to be removed. For example, as a user with root permissions:
```
$ grep -v format_string /etc/nova/nova.conf > /etc/ceilometer-agent.conf
```
Refer to configuration for details about any other options you might want to modify before starting the service.
Start the agent.
```
$ ./bin/ceilometer-agent
```
Note

The default development configuration of the agent 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.

Installing the API Server

double: installing; API