ad246afa6a
Update the following items for the Ubuntu release packages (2015.1): 1) Use RabbitMQ packages from the cloud archive repository. 2) Change default role from '_member_' to 'user' to avoid potential interference with an internal role. 3) Remove explicit configuration of 'log_dir' option in keystone. 4) Remove step to disable default host in Apache. 5) Update CirrOS image to 0.3.4. Some of these changes apply to all distributions. Change-Id: If1cdf839ebdc7655b89ab14df694a9c25f0c35cf Implements: blueprint installguide-kilo
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,user,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>
|