0ee4a3bc74
This adds an initial install of ceilometer to the install guide. This has not been tested. Also adds stub sections for adding agents/setting up notification to things. Change-Id: Ieb154f1412f32279550b0a5a4a0cafc1547b8b61
48 lines
2.3 KiB
XML
48 lines
2.3 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>Adding the Agent: Object Storage</title>
|
||
<procedure>
|
||
<step>
|
||
<para>In order to retrieve object store statistics, the Metering
|
||
Service needs access to Object Storage with
|
||
<literal>ResellerAdmin</literal> role. You should give this
|
||
role to your <literal>os_username</literal> user for tenant
|
||
<literal>os_tenant_name</literal>:
|
||
<screen><prompt>$</prompt> <userinput>keystone role-create --name=ResellerAdmin</userinput>
|
||
<computeroutput>+----------+----------------------------------+
|
||
| Property | Value |
|
||
+----------+----------------------------------+
|
||
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
||
| name | ResellerAdmin |
|
||
+----------+----------------------------------+
|
||
</computeroutput>
|
||
<prompt>$</prompt> <userinput>keystone user-role-add --tenant_id $SERVICE_TENANT \
|
||
--user_id $CEILOMETER_USER \
|
||
--role_id 462fa46c13fd4798a95a3bfbe27b5e54</userinput></screen>
|
||
</para>
|
||
</step>
|
||
<step>
|
||
<para>You’ll also need to add the Metering middleware to Object
|
||
Storage to account for incoming and outgoing traffic, by
|
||
adding these lines to
|
||
<filename>/etc/swift/proxy-server.conf</filename>:
|
||
<programlisting language="ini">[filter:ceilometer]
|
||
use = egg:ceilometer#swift</programlisting>Next,
|
||
add <literal>ceilometer</literal> to the
|
||
<literal>pipeline</literal> parameter of that same file,
|
||
right before the entry <literal>proxy-server</literal>.</para>
|
||
</step>
|
||
<step os="ubuntu;debian">
|
||
<para>We now restart the service with its new settings.</para>
|
||
<screen><prompt>#</prompt> <userinput>service swift-proxy-server restart</userinput></screen>
|
||
</step>
|
||
<step os="rhel;fedora;centos;opensuse"><para>We now restart the service with its new settings.</para>
|
||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>service openstack-swift-proxy-server restart</userinput></screen>
|
||
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy-server.service</userinput></screen>
|
||
</step>
|
||
</procedure>
|
||
</section>
|