openstack/openstack-manuals
Code Issues Proposed changes

Add doc for ceilometer IPMI agent

Browse Source 
Closes-Bug: #1369334

Change-Id: I87bb8c44bf80f2bfc1ed214c7c42e4415689e755
Signed-off-by: Zhai Edwin <edwin.zhai@intel.com>
This commit is contained in:
Edwin Zhai 2014-09-16 16:20:08 +08:00
parent de267faac9
commit 0ae2f9af57
2 changed files with 36 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/admin-guide-cloud/telemetry/section_telemetry-data-collection.xml
View File

@ -322,6 +322,33 @@
compute section</link> in the <filename>ceilometer.conf</filename> configuration
file.</para>
</section>
<section xml:id="section_telemetry-IPMI-agent">
<title>IPMI agent</title>
<para>This agent is responsible for collecting IPMI sensor data and Intel Node Manager
data on individual compute nodes within an OpenStack deployment. This
agent requires IPMI capable node with <application>ipmitool</application> installed, which
is a common utility for IPMI control on various Linux distributions.</para>
<para>An IPMI agent instance could be installed on each and every compute node
with IPMI support, except that the node is managed by Bare metal module for OpenStack
and the <option>conductor.send_sensor_data</option> option is set to <literal>true</literal>
in the Bare metal module for OpenStack.
It is no harm to install this agent on compute node without IPMI or Intel Node
Manager support, as the agent checks for the hardware and if none is available, returns empty data.
But it is suggested that you install IPMI agent only on IPMI capable node for performance reason.
</para>
<para>Just like the central agent, this component also does not need a direct database
access. The samples are sent via AMQP to the collector.
</para>
<para>The list of collected meters can be found in the <link xlink:href=
"http://docs.openstack.org/developer/ceilometer/measurements.html#ironic-hardware-ipmi-sensor-data">
Ironic Hardware IPMI Sensor Data section</link> in the <citetitle>Telemetery Measurements Reference</citetitle>.</para>
<note>
<para>Do not deploy both IPMI agent and Bare metal module for OpenStack on
one compute node. If <option>conductor.send_sensor_data</option> set, this
misconfiguration causes duplicated IPMI sensor samples.
</para>
</note>
</section>
</section>
<section xml:id="section_telemetry-post-api">
<title>Send samples to Telemetry</title>
@ -776,4 +803,4 @@ sinks:
</tbody>
</table>
</section>
</section>
</section>

9
doc/admin-guide-cloud/telemetry/section_telemetry-system-architecture.xml
View File

@ -42,6 +42,13 @@
<para>Consumes AMQP messages from other OpenStack services.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem class="service">ceilometer-agent-ipmi</systemitem></term>
<listitem>
<para>Polls compute node with IPMI support, in order to
acquire IPMI sensor data and Intel Node Manager data.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem class="service">ceilometer-collector</systemitem></term>
<listitem>
@ -213,4 +220,4 @@
initiated the action. Further details about alarm handling can be found in
<xref linkend="section_telemetry-alarms"/> in this guide.</para>
</section>
</section>
</section>