Merge "Includes overview information in the admin cloud guide"

doc/admin-guide-cloud/source/objectstorage.rst

@@ -12,6 +12,7 @@ Object Storage
    objectstorage_ringbuilder.rst
    objectstorage_arch.rst
    objectstorage_replication.rst
+   objectstorage_large-objects.rst
    objectstorage_auditors.rst
    objectstorage_EC.rst
    objectstorage_account_reaper.rst

doc/admin-guide-cloud/source/objectstorage_large-objects.rst

@@ -0,0 +1,35 @@
+====================
+Large object support
+====================
+
+Object Storage (swift) uses segmentation to support the upload of large
+objects. By default, Object Storage limits the download size of a single
+object to 5GB. Using segmentation, uploading a single object is virtually
+unlimited. The segmentation process works by fragmenting the object,
+and automatically creating a file that sends the segments together as
+a single object. This option offers greater upload speed with the possibility
+of parallel uploads.
+
+Large objects
+~~~~~~~~~~~~~
+The large object is comprised of two types of objects:
+
+-  **Segment objects** store the object content. You can divide your
+   content into segments, and upload each segment into its own segment
+   object. Segment objects do not have any special features. You create,
+   update, download, and delete segment objects just as you would normal
+   objects.
+
+-  A **manifest object** links the segment objects into one logical
+   large object. When you download a manifest object, Object Storage
+   concatenates and returns the contents of the segment objects in the
+   response body of the request. The manifest object types are:
+
+   - **Static large objects**
+   - **Dynamic large objects**
+
+To find out more information on large object support, see
+`Large objects <http://docs.openstack.org/user-guide/cli_swift_large_object_creation.html>`_
+in the End User Guide, or
+`Large Object Support <http://docs.openstack.org/developer/swift/overview_large_objects.html>`_
+in the developer documentation.