ceilometer/install-guide/source/install-base-rdo.rst

2.7 KiB

Install and configure for Red Hat Enterprise Linux and CentOS

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 create a database, service credentials, and API endpoints. However, unlike other services, the Telemetry service uses a NoSQL database. See environment-nosql-database-rdo to install and configure MongoDB before proceeding further.

  1. Create the ceilometer database:

    # mongo --host controller --eval '
      db = db.getSiblingDB("ceilometer");
      db.createUser({user: "ceilometer",
      pwd: "CEILOMETER_DBPASS",
      roles: [ "readWrite", "dbAdmin" ]})'
    
      MongoDB shell version: 2.6.x
      connecting to: controller:27017/test
      Successfully added user: { "user" : "ceilometer", "roles" : [ "readWrite", "dbAdmin" ] }

    Replace CEILOMETER_DBPASS with a suitable password.

Install and configure components

  1. Install the packages:

    # yum install openstack-ceilometer-api \
      openstack-ceilometer-collector openstack-ceilometer-notification \
      openstack-ceilometer-central python-ceilometerclient

Configure the Apache HTTP server

  • Create the /etc/httpd/conf.d/wsgi-ceilometer.conf file with the following content:

    Listen 8777
    
    <VirtualHost *:8777>
        WSGIDaemonProcess ceilometer-api processes=2 threads=10 user=ceilometer group=ceilometer display-name=%{GROUP}
        WSGIProcessGroup ceilometer-api
        WSGIScriptAlias / "/var/www/cgi-bin/ceilometer/app"
        WSGIApplicationGroup %{GLOBAL}
        ErrorLog /var/log/httpd/ceilometer_error.log
        CustomLog /var/log/httpd/ceilometer_access.log combined
    </VirtualHost>
    
    WSGISocketPrefix /var/run/httpd

Finalize installation

  1. Reload the Apache HTTP server:

    # systemctl reload httpd.service
  2. Start the Telemetry services and configure them to start when the system boots:

    # systemctl enable openstack-ceilometer-notification.service \
      openstack-ceilometer-central.service \
      openstack-ceilometer-collector.service
    # systemctl start openstack-ceilometer-notification.service \
      openstack-ceilometer-central.service \
      openstack-ceilometer-collector.service