openstack/openstack-manuals
Code Issues Proposed changes

Improvements to "Introduction to Object Storage"

Browse Source 
Includes:
1. Inclusion of erasure coding info
2. Note about default constraints

backport: mitaka

Change-Id: Ieae09f432b7186391ddad7124e28e0ab3409c94c
Closes-bug: #1596770
This commit is contained in:
Alexandra 2016-07-05 11:23:26 +01:00 committed by Alexandra Settle
parent a000ece7da
commit 9b0d117979
2 changed files with 29 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
doc/config-reference/source/object-storage/about.rst
View File

@ -2,23 +2,32 @@
Introduction to Object Storage Introduction to Object Storage
============================== ==============================
Object Storage is a robust, highly scalable and fault tolerant storage platform Object Storage (swift) is a robust, highly scalable and fault tolerant storage
for unstructured data such as objects. Objects are stored bits, accessed platform for unstructured data such as objects. Objects are stored bits,
through a RESTful, HTTP-based interface. You cannot access data at the block or accessed through a RESTful, HTTP-based interface. You cannot access data at
file level. Object Storage is commonly used to archive and back up data, with the block or file level. Object Storage is commonly used to archive and back
use cases in virtual machine image, photo, video and music storage. up data, with use cases in virtual machine image, photo, video, and music
storage.
Object Storage provides a high degree of availability, throughput, and Object Storage provides a high degree of availability, throughput, and
performance with its scale out architecture. Each object is replicated across performance with its scale out architecture. Each object is replicated across
multiple servers, residing within the same data center or across data centers, multiple servers, residing within the same data center or across data centers,
which mitigates the risk of network and hardware failure. In the event of which mitigates the risk of network and hardware failure. In the event of
hardware failure, Object Storage will automatically copy objects to a new hardware failure, Object Storage will automatically copy objects to a new
location to ensure that there are always three copies available. Object Storage location to ensure that your chosen number of copies are always available.
is an eventually consistent distributed storage platform; it sacrifices
consistency for maximum availability and partition tolerance. Object Storage
enables you to create a reliable platform by using commodity hardware and
inexpensive storage.
For more information, review the key concepts in the developer documentation at Object Storage also employs erasure coding. Erasure coding is a set of
`docs.openstack.org/developer/swift/ algorithms that allows the reconstruction of missing data from a set of
original data. In theory, erasure coding uses less storage capacity with
similar durability characteristics as replicas. From an application
perspective, erasure coding support is transparent. Object Storage
implements erasure coding as a Storage Policy.
Object Storage is an eventually consistent distributed storage platform;
it sacrifices consistency for maximum availability and partition tolerance.
Object Storage enables you to create a reliable platform by using commodity
hardware and inexpensive storage.
For more information, review the key concepts in the developer documentation
at `docs.openstack.org/developer/swift/
<http://docs.openstack.org/developer/swift/>`__. <http://docs.openstack.org/developer/swift/>`__.

10
doc/config-reference/source/object-storage/general-service-conf.rst
View File

@ -5,8 +5,8 @@ Object Storage general service configuration
Most Object Storage services fall into two categories, Object Storage's WSGI Most Object Storage services fall into two categories, Object Storage's WSGI
servers and background daemons. servers and background daemons.
Object Storage uses paste.deploy to manage server configurations. Read more at Object Storage uses ``paste.deploy`` to manage server configurations.
http://pythonpaste.org/deploy/. Read more at `<http://pythonpaste.org/deploy/>`_.
Default configuration options are set in the ``[DEFAULT]`` section, and any Default configuration options are set in the ``[DEFAULT]`` section, and any
options specified there can be overridden in any of the other sections when the options specified there can be overridden in any of the other sections when the
@ -38,6 +38,12 @@ the ``object-server``, ``object-updater``, ``object-replicator``, and
[object-auditor] [object-auditor]
.. note::
Default constraints can be overridden in ``swift.conf``. For example,
you can change the maximum object size and other variables.
Object Storage services expect a configuration path as the first argument: Object Storage services expect a configuration path as the first argument:
.. code-block:: console .. code-block:: console