Install the Compute agent for Telemetry

Telemetry provides an API service that provides a collector and a range of disparate agents. This procedure details how to install the agent that runs on the compute node.

1. Install the Telemetry service on the compute node:

   # yum install openstack-ceilometer-compute python-ceilometerclient python-pecan

2. Set the following options in the /etc/nova/nova.conf file:

   # openstack-config --set /etc/nova/nova.conf DEFAULT \
     instance_usage_audit True
   # openstack-config --set /etc/nova/nova.conf DEFAULT \
     instance_usage_audit_period hour
   # openstack-config --set /etc/nova/nova.conf DEFAULT \
     notify_on_state_change vm_and_task_state

   	Note
   	The notification_driver option is a multi valued option, which openstack-config cannot set properly. See the section called “OpenStack packages”.

   Edit the /etc/nova/nova.conf file and add the following lines to the [DEFAULT] section:

   [DEFAULT]
   ...
   notification_driver = nova.openstack.common.notifier.rpc_notifier
   notification_driver = ceilometer.compute.nova_notifier

3. Restart the Compute service:

   # service openstack-nova-compute restart

4. You must set the secret key that you defined previously. The Telemetry service nodes share this key as a shared secret:

   # openstack-config --set /etc/ceilometer/ceilometer.conf publisher \
     metering_secret CEILOMETER_TOKEN

5. Configure the QPid access:

   # openstack-config --set /etc/ceilometer/ceilometer.conf DEFAULT qpid_hostname controller

6. Add the Identity service credentials:

   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     keystone_authtoken auth_host controller
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     keystone_authtoken admin_user ceilometer
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     keystone_authtoken admin_tenant_name service
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     keystone_authtoken auth_protocol http
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     keystone_authtoken admin_password CEILOMETER_PASS
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     service_credentials os_username ceilometer
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     service_credentials os_tenant_name service
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     service_credentials os_password CEILOMETER_PASS
   # openstack-config --set /etc/ceilometer/ceilometer.conf \
     service_credentials os_auth_url http://controller:5000/v2.0

7. Start the service and configure it to start when the system boots:

   # service openstack-ceilometer-compute start
   # chkconfig openstack-ceilometer-compute on