ceilometer/doc/source/install/install-base-ubuntu.rst

Install and configure for Ubuntu

This section describes how to install and configure the Telemetry service, code-named ceilometer, on the controller node.

Prerequisites

Before you install and configure the Telemetry service, you must configure a target to send metering data to. The recommended endpoint is Gnocchi.

Install Gnocchi

1. Install the Gnocchi packages. Alternatively, Gnocchi can be installed using pip:

   # apt-get install gnocchi-api gnocchi-metricd python3-gnocchiclient

   Note

   Depending on your environment size, consider installing Gnocchi separately as it makes extensive use of the cpu.

2. Install the uWSGI packages. The following method uses operating system provided packages. Another alternative would be to use pip(or pip3, depending on the distribution); using pip is not described in this doc:

   # apt-get install uwsgi-plugin-python3 uwsgi

   Note

   Since the provided gnocchi-api wraps around uwsgi, you need to make sure that uWSGI is installed if you want to use gnocchi-api to run Gnocchi API. As Gnocchi API tier runs using WSGI, it can also alternatively be run using Apache httpd and mod_wsgi, or any other HTTP daemon.

Finalize Gnocchi installation

1. Restart the Gnocchi services:

   # service gnocchi-api restart
   # service gnocchi-metricd restart

Install and configure components

1. Install the ceilometer packages:

   # apt-get install ceilometer-agent-notification \
     ceilometer-agent-central

Finalize installation

1. Restart the Telemetry services:

   # service ceilometer-agent-central restart
   # service ceilometer-agent-notification restart