42b23e8c84
Closes-Bug: #1249082 Change-Id: I9f68073da5ca25867b2b8c099cce5df34f6a3eec author: diane fleming
77 lines
4.2 KiB
XML
77 lines
4.2 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<section xml:id="ceilometer-install-nova"
|
|
xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
|
<?dbhtml-stop-chunking?>
|
|
<title>Install the Compute agent for the Metering service</title>
|
|
<procedure>
|
|
<para>The Metering service consists of an API service, collector
|
|
and a range of disparate agents. This procedure details the
|
|
installation of the agent that runs on compute nodes.</para>
|
|
<step>
|
|
<para>Install the Metering service on the compute node:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ceilometer-agent-compute</userinput></screen>
|
|
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-compute</userinput></screen>
|
|
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-agent-compute</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Set the following options in the
|
|
<filename>/etc/nova/nova.conf</filename> file:</para>
|
|
<screen os="fedora;rhel;centos;opensuse;sles">
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT instance_usage_audit True</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT instance_usage_audit Hhour</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT notify_on_state_change vm_and_task_state</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT notification_driver nova.openstack.common.notifier.rpc_notifier</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT notification_driver ceilometer.compute.nova_driver</userinput></screen>
|
|
<para os="ubuntu;debian">Edit the
|
|
<filename>/etc/nova/nova.conf</filename> file and add the
|
|
following lines to the <literal>[DEFAULT]</literal>
|
|
section:</para>
|
|
<programlisting os="ubuntu;debian" language="ini">...
|
|
[DEFAULT]
|
|
...
|
|
instance_usage_audit=True
|
|
instance_usage_audit_period=hour
|
|
notify_on_state_change=vm_and_task_state
|
|
notification_driver=nova.openstack.common.notifier.rpc_notifier
|
|
notification_driver=ceilometer.compute.nova_notifier</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>You must set the secret key that you defined previously.
|
|
The Metering service nodes share this key as a shared
|
|
secret:</para>
|
|
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/keystone/keystone.conf publisher_rpc metering_secret $ADMIN_TOKEN</userinput></screen>
|
|
<para os="ubuntu;debian">Edit the
|
|
<filename>/etc/ceilometer/ceilometer.conf</filename> file
|
|
and change these lines in the <literal>[DEFAULT]</literal>
|
|
section. Replace <replaceable>ADMIN_TOKEN</replaceable> with
|
|
the admin token that you created previously:</para>
|
|
<programlisting os="ubuntu;debian" language="ini">...
|
|
[publisher_rpc]
|
|
# Secret value for signing metering messages (string value)
|
|
metering_secret = ADMIN_TOKEN
|
|
...</programlisting>
|
|
</step>
|
|
|
|
<step os="ubuntu;debian">
|
|
<para>Restart the service with its new settings:</para>
|
|
<screen><prompt>#</prompt> <userinput>service ceilometer-agent-compute restart</userinput></screen>
|
|
</step>
|
|
<step os="opensuse;sles">
|
|
<para>Start the <systemitem class="service"
|
|
>ceilometer-agent-compute</systemitem> service and configure
|
|
it to start when the system boots:</para>
|
|
<screen><prompt>#</prompt> <userinput>service openstack-ceilometer-agent-compute start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-agent-compute on</userinput></screen>
|
|
</step>
|
|
<step os="rhel;fedora;centos;">
|
|
<para>Start the <systemitem class="service"
|
|
>openstack-ceilometer-compute</systemitem> service and
|
|
configure to start when the system boots:</para>
|
|
<screen><prompt>#</prompt> <userinput>service openstack-ceilometer-compute start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-ceilometer-compute on</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|