56ae73a8f2
backport: havana Change-Id: I45b9394f22e5dd630a505acd30685bb33dbb60fd
47 lines
2.2 KiB
XML
47 lines
2.2 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<section xml:id="ceilometer-install-swift"
|
|
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">
|
|
<title>Add the Object Storage agent for the Telemetry service</title>
|
|
<procedure>
|
|
<step>
|
|
<para>To retrieve object store statistics, the Telemetry service
|
|
needs access to Object Storage with the
|
|
<literal>ResellerAdmin</literal> role. Give this role to
|
|
your <literal>os_username</literal> user for the
|
|
<literal>os_tenant_name</literal> tenant:</para>
|
|
<screen><prompt>$</prompt> <userinput>keystone role-create --name=ResellerAdmin</userinput>
|
|
<computeroutput>+----------+----------------------------------+
|
|
| Property | Value |
|
|
+----------+----------------------------------+
|
|
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
|
| name | ResellerAdmin |
|
|
+----------+----------------------------------+
|
|
</computeroutput></screen>
|
|
<screen><prompt>$</prompt> <userinput>keystone user-role-add --tenant service --user ceilometer \
|
|
--role <replaceable>462fa46c13fd4798a95a3bfbe27b5e54</replaceable></userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>You must also add the Telemetry middleware to Object
|
|
Storage to handle incoming and outgoing traffic. Add
|
|
these lines to the
|
|
<filename>/etc/swift/proxy-server.conf</filename>
|
|
file:</para>
|
|
<programlisting language="ini">[filter:ceilometer]
|
|
use = egg:ceilometer#swift</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>Add <literal>ceilometer</literal> to the
|
|
<literal>pipeline</literal> parameter of that same file:</para>
|
|
<programlisting language="ini">[pipeline:main]
|
|
pipeline = healthcheck cache authtoken keystoneauth ceilometer proxy-server</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>Restart the service with its new settings:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service swift-proxy-server restart</userinput></screen>
|
|
<screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-swift-proxy-server restart</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|