Add admin user guide for Manila

This patch adds admin user guide for Manila.

Change-Id: I8b58422130412953518cb37fdd1d69230400da8d

doc/user-guide-admin/source/dashboard.rst

@@ -18,6 +18,7 @@ Guide <http://docs.openstack.org/user-guide/>`__.
    dashboard_manage_instances.rst
    dashboard_manage_flavors.rst
    dashboard_manage_volumes.rst
+   dashboard_manage_shares.rst
    dashboard_set_quotas
    dashboard_manage_resources.rst
    dashboard_manage_host_aggregates.rst

doc/user-guide-admin/source/dashboard_manage_shares.rst

@@ -0,0 +1,137 @@
+=============================
+Manage shares and share types
+=============================
+
+Shares are file storage that instances can have access to. Users can
+allow or deny a running instance to have access to a share at any time.
+For information about using the dashboard to create and manage shares as
+an end user, see the
+`OpenStack End User Guide <http://docs.openstack.org/user-guide/dashboard_manage_shares.html>`_.
+
+As an administrative user, you can manage shares and share types for users
+in various projects. You can create and delete share types, and you can view
+and delete shares.
+
+.. _create-a-share-type:
+
+Create a share type
+~~~~~~~~~~~~~~~~~~~
+
+#. Log in to the dashboard and choose the :guilabel:`admin`
+   project from the drop-down list at the top of the page.
+
+#. On the :guilabel:`Admin` tab, open the :guilabel:`System` tab
+   and click the :guilabel:`Shares` category.
+
+#. Click the :guilabel:`Share Types` tab, and click
+   :guilabel:`Create Share Type` button. In the
+   :guilabel:`Create Share Type` window, enter or select the
+   following values.
+
+   :guilabel:`Name`: Enter a name for the share type.
+
+   :guilabel:`Driver handles share servers`: Choose True or False
+
+   :guilabel:`Extra specs`: To add extra specs, use key=value.
+
+#. Click :guilabel:`Create Share Type` button to confirm your changes.
+
+.. note:: A message indicates whether the action succeeded.
+
+Update share type
+~~~~~~~~~~~~~~~~~
+
+#. Log in to the dashboard and choose the :guilabel:`admin` project from
+   the drop-down list at the top of the page.
+
+#. On the :guilabel:`Admin` tab, open the :guilabel:`System` tab
+   and click the :guilabel:`Shares` category.
+
+#. Click the :guilabel:`Share Types` tab, select the share type
+   that you want to update.
+
+#. Select :guilabel:`Update Share Type` from Actions.
+
+#. In the :guilabel:`Update Share Type` window, update extra specs.
+
+   :guilabel:`Extra specs`: To add extra specs, use key=value.
+   To unset extra specs, use key.
+
+#. Click :guilabel:`Update Share Type` button to confirm your changes.
+
+.. note:: A message indicates whether the action succeeded.
+
+Delete share types
+~~~~~~~~~~~~~~~~~~
+
+When you delete a share type, shares of that type are not deleted.
+
+#. Log in to the dashboard and choose the :guilabel:`admin` project from
+   the drop-down list at the top of the page.
+
+#. On the :guilabel:`Admin` tab, open the :guilabel:`System` tab
+   and click the :guilabel:`Shares` category.
+
+#. Click the :guilabel:`Share Types` tab, select the share type
+   or types that you want to delete.
+
+#. Click :guilabel:`Delete Share Types` button.
+
+#. In the :guilabel:`Confirm Delete Share Types` window, click the
+   :guilabel:`Delete Share Types` button to confirm the action.
+
+.. note:: A message indicates whether the action succeeded.
+
+Delete shares
+~~~~~~~~~~~~~
+
+#. Log in to the dashboard and choose the :guilabel:`admin` project
+   from the drop-down list at the top of the page.
+
+#. On the :guilabel:`Admin` tab, open the :guilabel:`System` tab
+   and click the :guilabel:`Shares` category.
+
+#. Select the share or shares that you want to delete.
+
+#. Click :guilabel:`Delete Shares` button.
+
+#. In the :guilabel:`Confirm Delete Shares` window, click the
+   :guilabel:`Delete Shares` button to confirm the action.
+
+.. note:: A message indicates whether the action succeeded.
+
+Delete share server
+~~~~~~~~~~~~~~~~~~~
+
+#. Log in to the dashboard and choose the :guilabel:`admin` project
+   from the drop-down list at the top of the page.
+
+#. On the :guilabel:`Admin` tab, open the :guilabel:`System` tab
+   and click the :guilabel:`Share Servers` category.
+
+#. Select the share that you want to delete.
+
+#. Click :guilabel:`Delete Share Server` button.
+
+#. In the :guilabel:`Confirm Delete Share Server` window, click the
+   :guilabel:`Delete Share Server` button to confirm the action.
+
+.. note:: A message indicates whether the action succeeded.
+
+Delete share networks
+~~~~~~~~~~~~~~~~~~~~~
+
+#. Log in to the dashboard and choose the :guilabel:`admin` project
+   from the drop-down list at the top of the page.
+
+#. On the :guilabel:`Admin` tab, open the :guilabel:`System` tab
+   and click the :guilabel:`Share Networks` category.
+
+#. Select the share network or share networks that you want to delete.
+
+#. Click :guilabel:`Delete Share Networks` button.
+
+#. In the :guilabel:`Confirm Delete Share Networks` window, click the
+   :guilabel:`Delete Share Networks` button to confirm the action.
+
+.. note:: A message indicates whether the action succeeded.