Files
ceilometer/doc/source/install/install-base-ubuntu.rst
Han Guangyu 2e09c6525b Add the describe of uWSGI to run Gnocchi API
Gnocchi API coundn't be use if we don't install and configure uwsgi
or other HTTP daemon. And gnocchi install guide didn't describe
those.

Add the describe of installing uWSGI and the brief relationship
between uWSGI and Gnocchi API. And tell the reader that they can
also use Apache httpd and mod_wsgi, or any other HTTP daemon to
run Gnocchi API.

Closes-Bug: #1750933
Change-Id: Iba8c1fe7a64569de4ca366251c495731a8d7a779
2021-09-17 13:34:02 +08:00

2.1 KiB

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 python-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