<?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>