e78c9e3ac2
As per discussion in the OSA docs summit session, clean up of installation guide. This fixes typos, minor RST mark up changes, and passive voice. This patch also merges a some of the sections into the larger chapter. This is in an effort to remove multiple smaller files. This patch is the first of many to avoid major conflicts. Change-Id: I5b6d540bfa691b36dbe9cf909de8e61affb0cd92
64 lines
2.1 KiB
ReStructuredText
64 lines
2.1 KiB
ReStructuredText
`Home <index.html>`_ OpenStack-Ansible Installation Guide
|
||
|
||
Configuring the Object Storage (swift) service (optional)
|
||
=========================================================
|
||
|
||
.. toctree::
|
||
|
||
configure-swift-devices.rst
|
||
configure-swift-config.rst
|
||
configure-swift-glance.rst
|
||
configure-swift-add.rst
|
||
configure-swift-policies.rst
|
||
|
||
Object Storage (swift) is a multi-tenant Object Storage system. It is
|
||
highly scalable, can manage large amounts of unstructured data, and
|
||
provides a RESTful HTTP API.
|
||
|
||
The following procedure describes how to set up storage devices and
|
||
modify the Object Storage configuration files to enable swift
|
||
usage.
|
||
|
||
#. `The section called "Configure and mount storage
|
||
devices" <configure-swift-devices.html>`_
|
||
|
||
#. `The section called "Configure an Object Storage
|
||
deployment" <configure-swift-config.html>`_
|
||
|
||
#. Optionally, allow all Identity (keystone) users to use swift by setting
|
||
``swift_allow_all_users`` in the ``user_variables.yml`` file to
|
||
``True``. Any users with the ``_member_`` role (all authorized
|
||
keystone users) can create containers and upload objects
|
||
to Object Storage.
|
||
|
||
If this value is ``False``, then by default, only users with the
|
||
admin or ``swiftoperator`` role are allowed to create containers or
|
||
manage tenants.
|
||
|
||
When the backend type for the Image Service (glance) is set to
|
||
``swift``, glance can access the swift cluster
|
||
regardless of whether this value is ``True`` or ``False``.
|
||
|
||
|
||
Overview
|
||
~~~~~~~~
|
||
|
||
Object Storage (swift) is configured using the
|
||
``/etc/openstack_deploy/conf.d/swift.yml`` file and the
|
||
``/etc/openstack_deploy/user_variables.yml`` file.
|
||
|
||
When installing swift, use the group variables in the
|
||
``/etc/openstack_deploy/conf.d/swift.yml`` file for the Ansible
|
||
playbooks. Some variables cannot
|
||
be changed after they are set, while some changes require re-running the
|
||
playbooks. The values in the ``swift_hosts`` section supersede values in
|
||
the ``swift`` section.
|
||
|
||
To view the configuration files, including information about which
|
||
variables are required and which are optional, see `Appendix A, *OSA
|
||
configuration files* <app-configfiles.html>`_.
|
||
|
||
--------------
|
||
|
||
.. include:: navigation.txt
|