68 lines
3.3 KiB
XML
68 lines
3.3 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section 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"
|
|
xml:id="ceilometer-agent-swift">
|
|
<title>Configure the Object Storage service for Telemetry</title>
|
|
<procedure>
|
|
<step>
|
|
<para>Install the <package>python-ceilometerclient</package>
|
|
package on your Object Storage proxy server:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install python-ceilometerclient</userinput></screen>
|
|
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install python-ceilometerclient</userinput></screen>
|
|
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install python-ceilometerclient</userinput></screen>
|
|
</step>
|
|
<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>Add the system user <literal>swift</literal> to the system group
|
|
<literal>ceilometer</literal> to give Object Storage access to the
|
|
<filename>ceilometer.conf</filename> file.</para>
|
|
<screen>
|
|
<prompt>#</prompt> <userinput>usermod -a -G ceilometer swift</userinput>
|
|
</screen>
|
|
</step>
|
|
<step>
|
|
<para>Add <literal>ResellerAdmin</literal> to the
|
|
<literal>operator_roles</literal> parameter of that same file:</para>
|
|
<programlisting language="ini">operator_roles = Member,admin,swiftoperator,_member_,ResellerAdmin</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>Restart the service with its new settings:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service swift-proxy restart</userinput></screen>
|
|
<screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-swift-proxy restart</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|