This adds swift-specific contents from the OpenStack Installation Guide in the swift repo per [1]. A separate change will remove the swift contents from the OpenStack Installation Guide for Newton per [2]. The swift install-guide structure is based on the Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] http://git.openstack.org/cgit/openstack/installguide-cookiecutter/ Change-Id: I59b92eebaf5acc657b97bcf10d9ff2cf2db05885 Partially-Implements: blueprint projectspecificinstallguides Depends-On: Ifebc65b188c4f2ba35b61c0deae5ec24401df7f9
2.3 KiB
Finalize installation for Ubuntu and Debian
Note
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.
This section applies to Ubuntu 14.04 (LTS) and Debian.
Obtain the
/etc/swift/swift.conf
file from the Object Storage source repository:# curl -o /etc/swift/swift.conf \ https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/mitaka
Edit the
/etc/swift/swift.conf
file and complete the following actions:In the
[swift-hash]
section, configure the hash path prefix and suffix for your environment.[swift-hash] ... swift_hash_path_suffix = HASH_PATH_SUFFIX swift_hash_path_prefix = HASH_PATH_PREFIX
Replace HASH_PATH_PREFIX and HASH_PATH_SUFFIX with unique values.
Warning
Keep these values secret and do not change or lose them.
In the
[storage-policy:0]
section, configure the default storage policy:[storage-policy:0] ... name = Policy-0 default = yes
Copy the
swift.conf
file to the/etc/swift
directory on each storage node and any additional nodes running the proxy service.On all nodes, ensure proper ownership of the configuration directory:
# chown -R root:swift /etc/swift
On the controller node and any other nodes running the proxy service, restart the Object Storage proxy service including its dependencies:
# service memcached restart # service swift-proxy restart
On the storage nodes, start the Object Storage services:
# swift-init all start
Note
The storage node runs many Object Storage services and the
swift-init
command makes them easier to manage. You can ignore errors from services not running on the storage node.