1fba5cba59
Workaround for https://bugzilla.redhat.com/show_bug.cgi?id=1214928. Partially implements bp installguide-kilo. Change-Id: Idc6efc4e90f9bc63a632e1d4b4f07885716b1099
100 lines
4.6 KiB
XML
100 lines
4.6 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-swift">
|
|
<title>Configure the Object Storage service</title>
|
|
<para>To retrieve storage-oriented events and samples, configure the
|
|
Object Storage service to send notifications to the message bus.</para>
|
|
<procedure>
|
|
<title>To configure prerequisites</title>
|
|
<para>The Telemetry service requires access to the Object Storage
|
|
service using the <literal>ResellerAdmin</literal> role. Perform
|
|
these steps on the controller node.</para>
|
|
<step>
|
|
<para>Source the <literal>admin</literal> credentials to gain
|
|
access to admin-only CLI commands.</para>
|
|
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Create the <literal>ResellerAdmin</literal> role:</para>
|
|
<screen><prompt>$</prompt> <userinput>openstack role create ResellerAdmin</userinput>
|
|
<computeroutput>+-------+----------------------------------+
|
|
| Field | Value |
|
|
+-------+----------------------------------+
|
|
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
|
| name | ResellerAdmin |
|
|
+-------+----------------------------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Add the <literal>ResellerAdmin</literal> role to the
|
|
<literal>service</literal> tenant and <literal>ceilometer</literal>
|
|
user:</para>
|
|
<screen><prompt>$</prompt> <userinput>openstack role add --project service --user ceilometer ResellerAdmin</userinput>
|
|
<computeroutput>+-------+----------------------------------+
|
|
| Field | Value |
|
|
+-------+----------------------------------+
|
|
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
|
| name | ResellerAdmin |
|
|
+-------+----------------------------------+</computeroutput></screen>
|
|
</step>
|
|
</procedure>
|
|
<procedure>
|
|
<title>To configure notifications</title>
|
|
<para>Perform these steps on the controller and any other nodes that
|
|
run the Object Storage proxy service.</para>
|
|
<step>
|
|
<para>Edit the <filename>/etc/swift/proxy-server.conf</filename> file
|
|
and complete the following actions:</para>
|
|
<substeps>
|
|
<step>
|
|
<para>In the <literal>[filter:keystoneauth]</literal> section,
|
|
add the <literal>ResellerAdmin</literal> role:</para>
|
|
<programlisting language="ini">[filter:keystoneauth]
|
|
...
|
|
operator_roles = admin,_member_,ResellerAdmin</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>In the <literal>[pipeline:main]</literal> section, add
|
|
<literal>ceilometer</literal>:</para>
|
|
<programlisting language="ini">[pipeline:main]
|
|
...
|
|
pipeline = authtoken cache healthcheck keystoneauth proxy-logging ceilometer proxy-server</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>In the <literal>[filter:ceilometer]</literal> section, configure
|
|
notifications:</para>
|
|
<programlisting language="ini">[filter:ceilometer]
|
|
...
|
|
paste.filter_factory = ceilometermiddleware.swift:filter_factory
|
|
control_exchange = swift
|
|
url = rabbit://openstack:<replaceable>RABBIT_PASS</replaceable>@<replaceable>controller</replaceable>:5672/
|
|
driver = messagingv2
|
|
topic = notifications
|
|
log_level = WARN</programlisting>
|
|
<para>Replace <replaceable>RABBIT_PASS</replaceable> with the
|
|
password you chose for the <literal>openstack</literal> account in
|
|
<application>RabbitMQ</application>.</para>
|
|
</step>
|
|
</substeps>
|
|
</step>
|
|
<step>
|
|
<para>Add the <literal>swift</literal> system user to the
|
|
<literal>ceilometer</literal> system group to permit access to the
|
|
Telemetry configuration files by the Object Storage service:</para>
|
|
<screen><prompt>#</prompt> <userinput>usermod -a -G ceilometer swift</userinput></screen>
|
|
</step>
|
|
<step os="fedora;centos;rhel">
|
|
<!-- Workaround for https://bugzilla.redhat.com/show_bug.cgi?id=1214928. -->
|
|
<para>Install the <package>ceilometermiddleware</package> package:</para>
|
|
<screen><prompt>#</prompt> <userinput>pip install ceilometermiddleware</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Restart the Object Storage proxy service:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service swift-proxy restart</userinput></screen>
|
|
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy.service</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|