8f963115d7
I updated the installation guide for Juno release packages as follows: 1) Converted 'systemctl' commands to single lines. 2) Converted more sections to use 'systemctl' commands. 3) Added note about lengthy installation time for 'openstack-selinux' package. 4) Explicitly configured UUID tokens and SQL driver in keystone. RDO needs to update or remove the 'dist' configuration files for services. 5) Explicitly configured local file system store options in [glance_store] section that appeared two days before official release. Although the Ubuntu and RDO packages appear to work by default, late changes to configuration files tend to cause problems at some point. 6) Explicitly configured authentication strategy to keystone in nova on controller and compute nodes. I think we should avoid relying on defaults for this option and reconsider for Kilo, particularly with RDO packages. 7) Explicitly installed 'sysfsutils' package on nova compute nodes because nova looks for it during cinder volume operations. 8) Removed explicit installation of 'ipset' package on neutron network and compute nodes because the Ubuntu and RDO packages install it as a dependency. Not sure about SUSE, so I left the explicit installation. 9) Changed cinder example devices from /dev/sdb to /dev/sdb1 because LVM on CentOS didn't like the former. Note: The configuration changes mostly apply to RDO packages on CentOS, but given the time constraints, I fixed some other issues. Also, this patch ignores the sahara chapter. Closes-Bug: #1383925 Change-Id: I0c9bbbfe72b8f0358f00d4f82b90ce4976a90ea2
70 lines
3.6 KiB
XML
70 lines
3.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-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;centos;fedora"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy.service</userinput></screen>
|
|
<para os="sles">On SLES:</para>
|
|
<screen os="sles"><prompt>#</prompt> <userinput>service openstack-swift-proxy restart</userinput></screen>
|
|
<para os="opensuse">On openSUSE:</para>
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-swift-proxy.service</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|