d49150f21f
* specify version 3.0 for authentication * use correct URLs for sample configuration files * update/add output of commands * add modules to improve functionality * update keystone middleware to use identity v3 api Partially implements bp installguide-kilo Co-Authored-By: Matt Kassawara <mkassawara@gmail.com> Change-Id: I185b3110260ca2fb1d42a3612ac6c074f63fd4cc
104 lines
5.5 KiB
XML
104 lines
5.5 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="swift-finalize-installation">
|
|
<title>Finalize installation</title>
|
|
<procedure>
|
|
<title>Configure hashes and default storage policy</title>
|
|
<note>
|
|
<para>Default configuration files vary by distribution. You might need
|
|
to add these sections and options rather than modifying existing
|
|
sections and options. Also, an ellipsis (...) in the configuration
|
|
snippets indicates potential default configuration options that you
|
|
should retain.</para>
|
|
</note>
|
|
<step os="ubuntu;debian;rhel;centos;fedora">
|
|
<para>Obtain the <filename>/etc/swift/swift.conf</filename> file from
|
|
the Object Storage source repository:</para>
|
|
<screen><prompt>#</prompt> <userinput>curl -o /etc/swift/swift.conf \
|
|
https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/kilo</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Edit the <filename>/etc/swift/swift.conf</filename> file and
|
|
complete the following actions:</para>
|
|
<substeps>
|
|
<step>
|
|
<para>In the <literal>[swift-hash]</literal> section, configure
|
|
the hash path prefix and suffix for your environment.</para>
|
|
<programlisting language="ini">[swift-hash]
|
|
...
|
|
swift_hash_path_suffix = <replaceable>HASH_PATH_PREFIX</replaceable>
|
|
swift_hash_path_prefix = <replaceable>HASH_PATH_SUFFIX</replaceable></programlisting>
|
|
<para>Replace <replaceable>HASH_PATH_PREFIX</replaceable> and
|
|
<replaceable>HASH_PATH_SUFFIX</replaceable> with unique
|
|
values.</para>
|
|
<warning>
|
|
<para>Keep these values secret and do not change or lose
|
|
them.</para>
|
|
</warning>
|
|
</step>
|
|
<step>
|
|
<para>In the <literal>[storage-policy:0]</literal> section,
|
|
configure the default storage policy:</para>
|
|
<programlisting language="ini">[storage-policy:0]
|
|
...
|
|
name = Policy-0
|
|
default = yes</programlisting>
|
|
</step>
|
|
</substeps>
|
|
</step>
|
|
<step>
|
|
<para>Copy the <filename>swift.conf</filename> file to
|
|
the <literal>/etc/swift</literal> directory on each storage node
|
|
and any additional nodes running the proxy service.</para>
|
|
</step>
|
|
<step>
|
|
<para>On all nodes, ensure proper ownership of the configuration
|
|
directory:</para>
|
|
<screen><prompt>#</prompt> <userinput>chown -R swift:swift /etc/swift</userinput></screen>
|
|
</step>
|
|
<step os="ubuntu;debian">
|
|
<para>On the controller node and any other nodes running the proxy
|
|
service, restart the Object Storage proxy service including
|
|
its dependencies:</para>
|
|
<screen><prompt>#</prompt> <userinput>service memcached restart</userinput>
|
|
<prompt>#</prompt> <userinput>service swift-proxy restart</userinput></screen>
|
|
</step>
|
|
<step os="rhel;centos;fedora;sles;opensuse">
|
|
<para>On the controller node and any other nodes running the proxy
|
|
service, start the Object Storage proxy service including its
|
|
dependencies and configure them to start when the system boots:</para>
|
|
<screen><prompt>#</prompt> <userinput>systemctl enable openstack-swift-proxy.service memcached.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl start openstack-swift-proxy.service memcached.service</userinput></screen>
|
|
</step>
|
|
<step os="ubuntu;debian">
|
|
<para>On the storage nodes, start the Object Storage services:</para>
|
|
<screen><prompt>#</prompt> <userinput>swift-init all start</userinput></screen>
|
|
<note>
|
|
<para>The storage node runs many Object Storage services and the
|
|
<command>swift-init</command> command makes them easier to
|
|
manage. You can ignore errors from services not running on the
|
|
storage node.</para>
|
|
</note>
|
|
</step>
|
|
<step os="rhel;centos;fedora;opensuse;sles">
|
|
<para>On the storage nodes, start the Object Storage services and
|
|
configure them to start when the system boots:</para>
|
|
<screen><prompt>#</prompt> <userinput>systemctl enable openstack-swift-account.service openstack-swift-account-auditor.service \
|
|
openstack-swift-account-reaper.service openstack-swift-account-replicator.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl start openstack-swift-account.service openstack-swift-account-auditor.service \
|
|
openstack-swift-account-reaper.service openstack-swift-account-replicator.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable openstack-swift-container.service openstack-swift-container-auditor.service \
|
|
openstack-swift-container-replicator.service openstack-swift-container-updater.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl start openstack-swift-container.service openstack-swift-container-auditor.service \
|
|
openstack-swift-container-replicator.service openstack-swift-container-updater.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable openstack-swift-object.service openstack-swift-object-auditor.service \
|
|
openstack-swift-object-replicator.service openstack-swift-object-updater.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl start openstack-swift-object.service openstack-swift-object-auditor.service \
|
|
openstack-swift-object-replicator.service openstack-swift-object-updater.service</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|