Install and configure for Ubuntu¶

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 NoSQL database for Ubuntu to install and configure MongoDB before proceeding further.

1. Create the ceilometer database:

   # mongo --host controller --eval '
     db = db.getSiblingDB("ceilometer");
     db.addUser({user: "ceilometer",
     pwd: "CEILOMETER_DBPASS",
     roles: [ "readWrite", "dbAdmin" ]})'
   
     MongoDB shell version: 2.4.x
     connecting to: controller:27017/test
     {
      "user" : "ceilometer",
      "pwd" : "72f25aeee7ad4be52437d7cd3fc60f6f",
      "roles" : [
       "readWrite",
       "dbAdmin"
       ],
      "_id" : ObjectId("5489c22270d7fad1ba631dc3")
     }
   

   Replace CEILOMETER_DBPASS with a suitable password.

   Note

   If the command fails saying you are not authorized to insert a user, you may need to temporarily comment out the auth option in the /etc/mongodb.conf file, restart the MongoDB service using service mongodb restart, and try calling the command again.

2. Source the admin credentials to gain access to admin-only CLI commands:

   $ . admin-openrc
   

3. To create the service credentials, complete these steps:

   • Create the ceilometer user:

     $ openstack user create --domain default --password-prompt ceilometer
     User Password:
     Repeat User Password:
     +-----------+----------------------------------+
     | Field     | Value                            |
     +-----------+----------------------------------+
     | domain_id | e0353a670a9e496da891347c589539e9 |
     | enabled   | True                             |
     | id        | c859c96f57bd4989a8ea1a0b1d8ff7cd |
     | name      | ceilometer                       |
     +-----------+----------------------------------+
     

   • Add the admin role to the ceilometer user.

     $ openstack role add --project service --user ceilometer admin
     

     Note

     This command provides no output.

   • Create the ceilometer service entity:

     $ openstack service create --name ceilometer \
       --description "Telemetry" metering
     +-------------+----------------------------------+
     | Field       | Value                            |
     +-------------+----------------------------------+
     | description | Telemetry                        |
     | enabled     | True                             |
     | id          | 5fb7fd1bb2954fddb378d4031c28c0e4 |
     | name        | ceilometer                       |
     | type        | metering                         |
     +-------------+----------------------------------+
     

4. Create the Telemetry service API endpoints:

   $ openstack endpoint create --region RegionOne \
     metering public http://controller:8777
   +--------------+----------------------------------+
   | Field        | Value                            |
   +--------------+----------------------------------+
   | enabled      | True                             |
   | id           | b808b67b848d443e9eaaa5e5d796970c |
   | interface    | public                           |
   | region       | RegionOne                        |
   | region_id    | RegionOne                        |
   | service_id   | 5fb7fd1bb2954fddb378d4031c28c0e4 |
   | service_name | ceilometer                       |
   | service_type | metering                         |
   | url          | http://controller:8777           |
   +--------------+----------------------------------+
   
   $ openstack endpoint create --region RegionOne \
     metering internal http://controller:8777
   +--------------+----------------------------------+
   | Field        | Value                            |
   +--------------+----------------------------------+
   | enabled      | True                             |
   | id           | c7009b1c2ee54b71b771fa3d0ae4f948 |
   | interface    | internal                         |
   | region       | RegionOne                        |
   | region_id    | RegionOne                        |
   | service_id   | 5fb7fd1bb2954fddb378d4031c28c0e4 |
   | service_name | ceilometer                       |
   | service_type | metering                         |
   | url          | http://controller:8777           |
   +--------------+----------------------------------+
   
   $ openstack endpoint create --region RegionOne \
     metering admin http://controller:8777
   +--------------+----------------------------------+
   | Field        | Value                            |
   +--------------+----------------------------------+
   | enabled      | True                             |
   | id           | b2c00566d0604551b5fe1540c699db3d |
   | interface    | admin                            |
   | region       | RegionOne                        |
   | region_id    | RegionOne                        |
   | service_id   | 5fb7fd1bb2954fddb378d4031c28c0e4 |
   | service_name | ceilometer                       |
   | service_type | metering                         |
   | url          | http://controller:8777           |
   +--------------+----------------------------------+
   

Install and configure components¶

1. Install the packages:

   # apt-get install ceilometer-api ceilometer-collector \
     ceilometer-agent-central ceilometer-agent-notification \
     python-ceilometerclient
   

2. Edit the /etc/ceilometer/ceilometer.conf file and complete the following actions:

   • In the [database] section, configure database access:

     [database]
     ...
     connection = mongodb://ceilometer:CEILOMETER_DBPASS@controller:27017/ceilometer
     

     Replace CEILOMETER_DBPASS with the password you chose for the Telemetry service database. You must escape special characters such as ‘:’, ‘/’, ‘+’, and ‘@’ in the connection string in accordance with RFC2396.

     • In the [DEFAULT] and [oslo_messaging_rabbit] sections, configure RabbitMQ message queue access:

       [DEFAULT]
       ...
       rpc_backend = rabbit
       
       [oslo_messaging_rabbit]
       ...
       rabbit_host = controller
       rabbit_userid = openstack
       rabbit_password = RABBIT_PASS
       

       Replace RABBIT_PASS with the password you chose for the openstack account in RabbitMQ.

     • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

       [DEFAULT]
       ...
       auth_strategy = keystone
       
       [keystone_authtoken]
       ...
       auth_uri = http://controller:5000
       auth_url = http://controller:35357
       memcached_servers = controller:11211
       auth_type = password
       project_domain_name = default
       user_domain_name = default
       project_name = service
       username = ceilometer
       password = CEILOMETER_PASS
       

       Replace CEILOMETER_PASS with the password you chose for the ceilometer user in the Identity service.

   • In the [service_credentials] section, configure service credentials:

     [service_credentials]
     ...
     auth_type = password
     auth_url = http://controller:5000/v3
     project_domain_name = default
     user_domain_name = default
     project_name = service
     username = ceilometer
     password = CEILOMETER_PASS
     interface = internalURL
     region_name = RegionOne
     

     Replace CEILOMETER_PASS with the password you chose for the ceilometer user in the Identity service.

Configure the Apache HTTP server¶

1. Create the /etc/apache2/sites-available/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/apache2/ceilometer_error.log
       CustomLog /var/log/apache2/ceilometer_access.log combined
   </VirtualHost>
   
   WSGISocketPrefix /var/run/apache2
   

2. Enable the Telemetry service virtual hosts:

   # a2ensite ceilometer
   

Finalize installation¶

1. Reload the Apache HTTP server:

   # service apache2 reload
   

2. Restart the Telemetry services:

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