diff --git a/admin_manual/configuration_files/external_storage/images/openstack.png b/admin_manual/configuration_files/external_storage/images/openstack.png new file mode 100644 index 000000000..811a4eed9 Binary files /dev/null and b/admin_manual/configuration_files/external_storage/images/openstack.png differ diff --git a/admin_manual/configuration_files/external_storage/images/rackspace.png b/admin_manual/configuration_files/external_storage/images/rackspace.png new file mode 100644 index 000000000..4c46355fc Binary files /dev/null and b/admin_manual/configuration_files/external_storage/images/rackspace.png differ diff --git a/admin_manual/configuration_files/external_storage/openstack.rst b/admin_manual/configuration_files/external_storage/openstack.rst index 83aff5aae..4265edfa0 100644 --- a/admin_manual/configuration_files/external_storage/openstack.rst +++ b/admin_manual/configuration_files/external_storage/openstack.rst @@ -2,22 +2,41 @@ OpenStack Object Storage ======================== -OpenStack Object Storage is used to connect to an OpenStack Swift server. -Two authentication mechanisms are available: one is the generic OpenStack -mechanism, and the other is used exclusively for Rackspace, a provider of object -storage that uses the OpenStack Swift protocol. - -The bucket will be created if it does not exist. +OpenStack Object Storage is used to connect to an OpenStack Swift server, or to +Rackspace. Two authentication mechanisms are available: one is the generic +OpenStack mechanism, and the other is used exclusively for Rackspace, a provider +of object storage that uses the OpenStack Swift protocol. The OpenStack authentication mechanism uses the OpenStack Keystone v2 -protocol, connecting to the server specified in the **URL of Identity -Endpoint** field. You need your **Username**, **Tenant name** and **Password**. +protocol. Your ownCloud configuration needs: -The Rackspace authentication mechanism requires a Rackspace **Username** and -**API key**. +* **Bucket**. This is user-defined; think of it as a subdirectory of your total + storage. The bucket will be created if it does not exist. +* **Username** of your account. +* **Password** of your account. +* **Tenant name** of your account. (A tenant is similar to a user group.) +* **Identity Endpoint URL**, the URL to log in to your OpenStack account. -It may be necessary to specify a **Service name** or **Region**. The timeout of -HTTP requests is set in the **Request timeout** field, in seconds. +.. figure:: images/openstack.png + :alt: Openstack configuration. + +The Rackspace authentication mechanism requires: + +* **Bucket** +* **Username** +* **API key**. + +You must also enter the term **cloudFiles** in the **Service name** field. + +.. figure:: images/rackspace.png + :alt: Openstack configuration. + +It may be necessary to specify a **Region**. Your region should be named in +your account information, and you can read about Rackspace regions at +`About Regions `_. + +The timeout of HTTP requests is set in the **Request timeout** field, in +seconds. See :doc:`../external_storage_configuration_gui` for additional mount options and information.