openstack/openstack-manuals
Code Issues Proposed changes

Merge "Cloud Admin Guide: Shared File Systems updated information"

Browse Source
This commit is contained in:
Jenkins 2015-10-28 22:14:04 +00:00 committed by Gerrit Code Review
commit 41a93dfaec
17 changed files with 1267 additions and 1075 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

355
doc/admin-guide-cloud/source/shared_file_systems_cgroups.rst
View File

@ -4,36 +4,37 @@
Consistency groups Consistency groups
================== ==================
Consistency groups enable you to create snapshots at the exact same point in Consistency groups enable you to create snapshots from multiple file system
time from multiple file system shares. For example, a database might place its shares at the same point in time. For example, a database might place its
tables, logs, and configuration on separate shares. To restore this database tables, logs, and configuration on separate shares. To restore this database
from a previous point in time, it makes sense to restore the logs, tables, and from a previous point in time, it makes sense to restore the logs, tables, and
configuration together from the exact same point in time. configuration together from the exact same point in time.
Shared File system allows you to create a snapshot of the consistency group and The Shared File System service allows you to create a snapshot of the
restore all shares that were associated with the consistency group by creating consistency group and restore all shares that were associated with a
a consistency group from a snapshot. consistency group.
.. note:: .. note::
The **consistency groups and snapshots** are realized as an The **consistency groups and snapshots** are realized as an
**experimental** Shared File Systems API. Contributors can change or remove **experimental** Shared File Systems API in Liberty release. Contributors
the experimental part of the Shared File Systems API without maintaining can change or remove the experimental part of the Shared File Systems API
backward compatibility. The experimental API has in further releases without maintaining backward compatibility. The
``"X-OpenStack-Manila-API-Experimental: true"`` header in their HTTP experimental API has ``"X-OpenStack-Manila-API-Experimental: true"`` header
requests. in their HTTP requests.
Consistency groups Consistency groups
------------------ ------------------
.. note:: .. note::
Before using consistency groups, make sure the Shared File System driver that Before using consistency groups, make sure the Shared File System driver
you are running has consistency group support. You can check it in the manila that you are running has consistency group support. You can check it in the
scheduler reports. The ``consistency_group_support`` can have such values: ``manila-scheduler`` service reports. The ``consistency_group_support`` can
have such values:
* ``pool`` or ``host``. Consistency groups are supported. Specifies the * ``pool`` or ``host``. Consistency groups are supported. Specifies the
level of consistency groups support. level of consistency groups support.
* ``false``. Consistency groups are not supported. * ``false``. Consistency groups are not supported.
Create a new consistency group, specify a share network and one or more share Create a new consistency group, specify a share network and one or more share
types. In the example a consistency group ``cgroup1`` was created with types. In the example a consistency group ``cgroup1`` was created with
@ -41,45 +42,45 @@ specifying two comma-separated share types:
.. code:: console .. code:: console
$ manila cg-create --name cgroup1 --description "My first CG." --share-types my_type1,default --share-network my_share_net $ manila cg-create --name cgroup1 --description "My first CG." --share-types my_type1,default --share-network my_share_net
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| Property | Value | | Property | Value |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| status | creating | | status | creating |
| description | My first CG. | | description | My first CG. |
| source_cgsnapshot_id | None | | source_cgsnapshot_id | None |
| created_at | 2015-09-29T15:01:12.102472 | | created_at | 2015-09-29T15:01:12.102472 |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| share_server_id | None | | share_server_id | None |
| host | None | | host | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| share_types | a4218aa5-f16a-42b3-945d-113496d40558 | | share_types | a4218aa5-f16a-42b3-945d-113496d40558 |
| | c0086582-30a6-4060-b096-a42ec9d66b86 | | | c0086582-30a6-4060-b096-a42ec9d66b86 |
| id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 | | id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 |
| name | cgroup1 | | name | cgroup1 |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
Check that consistency group is in available status: Check that consistency group is in available status:
.. code:: console .. code:: console
$ manila cg-show cgroup1 $ manila cg-show cgroup1
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| Property | Value | | Property | Value |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| status | available | | status | available |
| description | My first CG. | | description | My first CG. |
| source_cgsnapshot_id | None | | source_cgsnapshot_id | None |
| created_at | 2015-09-29T15:05:40.000000 | | created_at | 2015-09-29T15:05:40.000000 |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| share_server_id | None | | share_server_id | None |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| share_types | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_types | c0086582-30a6-4060-b096-a42ec9d66b86 |
| | a4218aa5-f16a-42b3-945d-113496d40558 | | | a4218aa5-f16a-42b3-945d-113496d40558 |
| id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 | | id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 |
| name | cgroup1 | | name | cgroup1 |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
To add a share to the consistency group you need to create a share with a To add a share to the consistency group you need to create a share with a
``--consistency-group`` option where you specify the ID of the consistency ``--consistency-group`` option where you specify the ID of the consistency
@ -87,34 +88,34 @@ group in ``available`` status:
.. code:: console .. code:: console
$ manila create nfs 1 --name "Share2" --description "My second share" --share-type default --share-network my_share_net --consistency-group cgroup1 $ manila create nfs 1 --name "Share2" --description "My second share" --share-type default --share-network my_share_net --consistency-group cgroup1
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| status | None | | status | None |
| share_type_name | default | | share_type_name | default |
| description | My second share | | description | My second share |
| availability_zone | None | | availability_zone | None |
| share_network_id | None | | share_network_id | None |
| export_locations | [] | | export_locations | [] |
| share_server_id | None | | share_server_id | None |
| host | None | | host | None |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | 7bcd888b-681b-4836-ac9c-c3add4e62537 | | id | 7bcd888b-681b-4836-ac9c-c3add4e62537 |
| size | 1 | | size | 1 |
| name | Share2 | | name | Share2 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-29T15:09:24.156387 | | created_at | 2015-09-29T15:09:24.156387 |
| export_location | None | | export_location | None |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 | | consistency_group_id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {} | | metadata | {} |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
Admin can rename the consistency group or change its description using Admin can rename the consistency group or change its description using
**manila cg-update** command, or delete it by **manila cg-delete**. **manila cg-update** command, or delete it by **manila cg-delete**.
@ -130,25 +131,25 @@ If no state is provided, available will be used.
.. code:: console .. code:: console
$ manila cg-reset-state cgroup1 --state error $ manila cg-reset-state cgroup1 --state error
Use **manila cg-delete <consistency_group> [<consistency_group> ...]** to Use **manila cg-delete <consistency_group> [<consistency_group> ...]** to
soft-delete one or more consistency group. soft-delete one or more consistency group.
.. note:: .. note::
The consistency group can be deleted only if it has no dependent The consistency group can be deleted only if it has no dependent
:ref:`shared_file_systems_cgsnapshots`. :ref:`shared_file_systems_cgsnapshots`.
.. code:: console .. code:: console
$ manila cg-delete cgroup1 $ manila cg-delete cgroup1
Use **manila cg-delete --force <consistency_group> [<consistency_group> ...]** Use **manila cg-delete --force <consistency_group> [<consistency_group> ...]**
to force-delete a specified consistency group in any state. to force-delete a specified consistency group in any state.
.. code:: console .. code:: console
$ manila cg-delete --force cgroup1 $ manila cg-delete --force cgroup1
.. _shared_file_systems_cgsnapshots: .. _shared_file_systems_cgsnapshots:
@ -164,35 +165,35 @@ Create a snapshot of consistency group ``cgroup1``:
.. code:: console .. code:: console
$ manila cg-snapshot-create cgroup1 --name CG_snapshot1 --description "A snapshot of the first CG." $ manila cg-snapshot-create cgroup1 --name CG_snapshot1 --description "A snapshot of the first CG."
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| Property | Value | | Property | Value |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| status | creating | | status | creating |
| name | CG_snapshot1 | | name | CG_snapshot1 |
| created_at | 2015-09-29T15:26:16.839704 | | created_at | 2015-09-29T15:26:16.839704 |
| consistency_group_id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 | | consistency_group_id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| id | 876ad24c-1efd-4607-a2b1-6a2c90034fa5 | | id | 876ad24c-1efd-4607-a2b1-6a2c90034fa5 |
| description | A snapshot of the first CG. | | description | A snapshot of the first CG. |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
Check the status of created consistency group snapshot: Check the status of created consistency group snapshot:
.. code:: console .. code:: console
$ manila cg-snapshot-show CG_snapshot1 $ manila cg-snapshot-show CG_snapshot1
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| Property | Value | | Property | Value |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
| status | available | | status | available |
| name | CG_snapshot1 | | name | CG_snapshot1 |
| created_at | 2015-09-29T15:26:22.000000 | | created_at | 2015-09-29T15:26:22.000000 |
| consistency_group_id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 | | consistency_group_id | 6fdd91bc-7a48-48b4-8e40-0f4f98d0ecd6 |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| id | 876ad24c-1efd-4607-a2b1-6a2c90034fa5 | | id | 876ad24c-1efd-4607-a2b1-6a2c90034fa5 |
| description | A snapshot of the first CG. | | description | A snapshot of the first CG. |
+----------------------+--------------------------------------+ +----------------------+--------------------------------------+
Admin can rename the consistency group snapshot or change its description using Admin can rename the consistency group snapshot or change its description using
**cg-snapshot-update** command, or delete it by **cg-snapshot-delete**. **cg-snapshot-update** command, or delete it by **cg-snapshot-delete**.
@ -211,47 +212,47 @@ group snapshot is ``Share2`` share:
.. code:: console .. code:: console
$ manila cg-snapshot-members CG_snapshot1 $ manila cg-snapshot-members CG_snapshot1
+--------------+------+----------------------------+----------------+--------------+--------------+ +--------------+------+----------------------------+----------------+--------------+--------------+
| Id | Size | Created_at | Share_protocol | Share_id | Share_type_id| | Id | Size | Created_at | Share_protocol | Share_id | Share_type_id|
+--------------+------+----------------------------+----------------+--------------+--------------+ +--------------+------+----------------------------+----------------+--------------+--------------+
| 5c62af2b-... | 1 | 2015-09-29T15:26:22.000000 | NFS | 7bcd888b-... | c0086582-... | | 5c62af2b-... | 1 | 2015-09-29T15:26:22.000000 | NFS | 7bcd888b-... | c0086582-... |
+--------------+------+----------------------------+----------------+--------------+--------------+ +--------------+------+----------------------------+----------------+--------------+--------------+
After you create a consistency group snapshot, you can create a consistency After you create a consistency group snapshot, you can create a consistency
group from it: group from it:
.. code:: console .. code:: console
$ manila cg-create --source-cgsnapshot-id 876ad24c-1efd-4607-a2b1-6a2c90034fa5 --name cgroup2 --description "A consistency group from a CG snapshot." $ manila cg-create --source-cgsnapshot-id 876ad24c-1efd-4607-a2b1-6a2c90034fa5 --name cgroup2 --description "A consistency group from a CG snapshot."
+----------------------+-----------------------------------------+ +----------------------+-----------------------------------------+
| Property | Value | | Property | Value |
+----------------------+-----------------------------------------+ +----------------------+-----------------------------------------+
| status | creating | | status | creating |
| description | A consistency group from a CG snapshot. | | description | A consistency group from a CG snapshot. |
| source_cgsnapshot_id | 876ad24c-1efd-4607-a2b1-6a2c90034fa5 | | source_cgsnapshot_id | 876ad24c-1efd-4607-a2b1-6a2c90034fa5 |
| created_at | 2015-09-29T15:47:47.937991 | | created_at | 2015-09-29T15:47:47.937991 |
| share_network_id | None | | share_network_id | None |
| share_server_id | None | | share_server_id | None |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| share_types | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_types | c0086582-30a6-4060-b096-a42ec9d66b86 |
| | a4218aa5-f16a-42b3-945d-113496d40558 | | | a4218aa5-f16a-42b3-945d-113496d40558 |
| id | ffee08d9-c86c-45e5-861e-175c731daca2 | | id | ffee08d9-c86c-45e5-861e-175c731daca2 |
| name | cgroup2 | | name | cgroup2 |
+----------------------+-----------------------------------------+ +----------------------+-----------------------------------------+
Check the list of consistency group. There are two groups now: Check the list of consistency group. There are two groups now:
.. code:: console .. code:: console
$ manila cg-list $ manila cg-list
+-------------------+---------+-----------------------------------------+-----------+ +-------------------+---------+-----------------------------------------+-----------+
| id | name | description | status | | id | name | description | status |
+-------------------+---------+-----------------------------------------+-----------+ +-------------------+---------+-----------------------------------------+-----------+
| 6fdd91bc-7a48-... | cgroup1 | My first CG. | available | | 6fdd91bc-7a48-... | cgroup1 | My first CG. | available |
| ffee08d9-c86c-... | cgroup2 | A consistency group from a CG snapshot. | available | | ffee08d9-c86c-... | cgroup2 | A consistency group from a CG snapshot. | available |
+-------------------+---------+-----------------------------------------+-----------+ +-------------------+---------+-----------------------------------------+-----------+
Check a list of the shares. New share with Check a list of the shares. New share with
``ba52454e-2ea3-47fa-a683-3176a01295e6`` ID was created when you created a ``ba52454e-2ea3-47fa-a683-3176a01295e6`` ID was created when you created a
@ -259,52 +260,52 @@ consistency group ``cgroup2`` from a snapshot with a member.
.. code:: console .. code:: console
$ manila list $ manila list
+------+-------+-----+------------+----------+----------+-----------+--------------------------+ +------+-------+-----+------------+----------+----------+-----------+--------------------------+
| ID | Name | Size| Share Proto| Status | Is Public| Share Type| Host | | ID | Name | Size| Share Proto| Status | Is Public| Share Type| Host |
+------+-------+-----+------------+----------+----------+-----------+--------------------------+ +------+-------+-----+------------+----------+----------+-----------+--------------------------+
| 7bc..| Share2| 1 | NFS | available| False | c008658...| manila@generic1#GENERIC1 | | 7bc..| Share2| 1 | NFS | available| False | c008658...| manila@generic1#GENERIC1 |
| ba5..| None | 1 | NFS | available| False | c008658...| manila@generic1#GENERIC1 | | ba5..| None | 1 | NFS | available| False | c008658...| manila@generic1#GENERIC1 |
+------+-------+-----+------------+----------+----------+-----------+--------------------------+ +------+-------+-----+------------+----------+----------+-----------+--------------------------+
Print detailed information about new share: Print detailed information about new share:
.. note:: .. note::
Pay attention on the ``source_cgsnapshot_member_id`` and Pay attention on the ``source_cgsnapshot_member_id`` and
``consistency_group_id`` fields in a new share. It has ``consistency_group_id`` fields in a new share. It has
``source_cgsnapshot_member_id`` that is equal to the ID of the consistency ``source_cgsnapshot_member_id`` that is equal to the ID of the consistency
group snapshot and ``consistency_group_id`` that is equal to the ID of group snapshot and ``consistency_group_id`` that is equal to the ID of
``cgroup2`` that was created from a snapshot. ``cgroup2`` that was created from a snapshot.
.. code:: console .. code:: console
$ manila show ba52454e-2ea3-47fa-a683-3176a01295e6 $ manila show ba52454e-2ea3-47fa-a683-3176a01295e6
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
| status | available | | status | available |
| share_type_name | default | | share_type_name | default |
| description | None | | description | None |
| availability_zone | None | | availability_zone | None |
| share_network_id | None | | share_network_id | None |
| export_locations | 10.254.0.5:/shares/share-5acadf4d-f81a-4515-b5ce-3ab641ab4d1e | | export_locations | 10.254.0.5:/shares/share-5acadf4d-f81a-4515-b5ce-3ab641ab4d1e |
| share_server_id | None | | share_server_id | None |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | ba52454e-2ea3-47fa-a683-3176a01295e6 | | id | ba52454e-2ea3-47fa-a683-3176a01295e6 |
| size | 1 | | size | 1 |
| name | None | | name | None |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-29T15:47:48.000000 | | created_at | 2015-09-29T15:47:48.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | ffee08d9-c86c-45e5-861e-175c731daca2 | | consistency_group_id | ffee08d9-c86c-45e5-861e-175c731daca2 |
| source_cgsnapshot_member_id | 5c62af2b-0870-4d00-b3fa-174831eb15ca | | source_cgsnapshot_member_id | 5c62af2b-0870-4d00-b3fa-174831eb15ca |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {} | | metadata | {} |
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
As an administrator, you can also reset the state of a consistency group As an administrator, you can also reset the state of a consistency group
snapshot with **cg-snapshot-reset-state** and force-delete a specified snapshot with **cg-snapshot-reset-state** and force-delete a specified

708
doc/admin-guide-cloud/source/shared_file_systems_crud_share.rst
View File

@ -4,98 +4,290 @@
Share basic operations Share basic operations
====================== ======================
Create share General concepts
------------ ----------------
General concepts **to create file share**, you need to: As general concepts, to create a file share and access it you need to:
#. To create a share, use :command:`manila create` command and #. To create a share, use :command:`manila create` command and
specify the required arguments: the size of the share and the Shared File specify the required arguments: the size of the share and the shared file
Systems protocol (``NFS``, ``CIFS``, ``GlusterFS``, or ``HDFS`` are system protocol. ``NFS``, ``CIFS``, ``GlusterFS``, or ``HDFS`` share file
supported). system protocols are supported.
#. You can also optionally specify the share network and the share type. #. You can also optionally specify the share network and the share type.
#. Use the :command:`manila create` command to create a share. This command #. After the share becomes available, use the :command:`manila show` command
does the following things: to get the share export location.
* If there is no available share servers, the Shared File Systems service #. After getting the share export location, you can create an
service will launch new instance from service image, attach it to service :ref:`access rule <access_to_share>` for the share, mount it and work with
network and register it as a new share server. files on the remote file system.
* Creates new volume of required size and attaches it to the service There are big number of the share drivers created by different vendors in the
instance. Shared File Systems service. As a Python class, each share driver can be set
for the :ref:`back end <shared_file_systems_multi_backend>` and run in the back
end to manage the share operations.
* The NFS service on service instance is configured to use attached volume Initially there are two driver modes for the back ends:
and expose NFS share.
#. After share becomes available, use the :command:`manila show` command * no share servers mode
to get the share endpoint. * share servers mode
In the example to create a share, the default share type and the Each share driver supports one or two of possible back end modes that can be
existing already share network are used. configured in :file:`manila.conf` file. The configuration option
``driver_handles_share_servers`` in :file:`manila.conf` file sets the share
servers mode or no share servers mode, and defines the driver mode for share
storage life cycle management:
.. note:: +------------------+-------------------------------------+--------------------+
There is no default share type just after you starting manila as the | Mode | Config option | Description |
administrator. See :ref:`shared_file_systems_share_types` to +==================+=====================================+====================+
create the default share type. To create a share network, use | no share servers | driver_handles_share_servers = False| An administrator |
:ref:`shared_file_systems_share_networks`. | | | rather than a share|
| | | driver manages the |
| | | bare metal storage |
| | | with some net |
| | | interface instead |
| | | of the presence of |
| | | the share servers. |
+------------------+-------------------------------------+--------------------+
| share servers | driver_handles_share_servers = True | The share driver |
| | | creates the share |
| | | server and manages,|
| | | or handles, the |
| | | share server life |
| | | cycle. |
+------------------+-------------------------------------+--------------------+
It is :ref:`the share types <shared_file_systems_share_types>` which have the
extra specifications that help scheduler to filter back ends and choose the
appropriate back end for the user that requested to create a share. The
required extra boolean specification for each share type is
``driver_handles_share_servers``. As an administrator, you can create the share
types with the specifications you need. For details of managing the share types
and configuration the back ends, see :ref:`shared_file_systems_share_types` and
:ref:`shared_file_systems_multi_backend` documentation.
You can create a share in two described above modes:
* in a no share servers mode without specifying the share network and
specifying the share type with ``driver_handles_share_servers = False``
parameter. See subsection :ref:`create_share_in_no_share_server_mode`.
* in a share servers mode with specifying the share network and the share
type with ``driver_handles_share_servers = True`` parameter. See subsection
:ref:`create_share_in_share_server_mode`.
.. _create_share_in_no_share_server_mode:
Create a share in no share servers mode
---------------------------------------
To create a file share in no share servers mode, you need to:
#. To create a share, use :command:`manila create` command and
specify the required arguments: the size of the share and the shared file
system protocol. ``NFS``, ``CIFS``, ``GlusterFS``, or ``HDFS`` share file
system protocols are supported.
#. You should specify the :ref:`share type <shared_file_systems_share_types>`
with ``driver_handles_share_servers = False`` extra specification.
#. You must not specify the ``share network`` because no share servers are
created. In this mode the Shared File Systems service expects that
administrator has some bare metal storage with some net interface.
#. The :command:`manila create` command creates a share. This command does the
following things:
* The :ref:`manila-scheduler <shared_file_systems_scheduling>` service will
find the back end with ``driver_handles_share_servers = False`` mode due
to filtering the extra specifications of the share type.
* The shared is created using the storage that is specified in the found
back end.
#. After the share becomes available, use the :command:`manila show` command
to get the share export location.
In the example to create a share, the created already share type named
``my_type`` with ``driver_handles_share_servers = False`` extra specification
is used.
Check share types that exist, run: Check share types that exist, run:
.. code:: console .. code:: console
$ manila type-list $ manila type-list
+------+--------+-----------+-----------+----------------------------------+----------------------+ +------+--------+-----------+------------------------------------+----------------------+
| ID | Name | Visibility| is_default| required_extra_specs | optional_extra_specs | | ID | Name | is_default| required_extra_specs | optional_extra_specs |
+------+--------+-----------+-----------+----------------------------------+----------------------+ +------+--------+-----------+------------------------------------+----------------------+
| c0...| default| public | YES | driver_handles_share_servers:True| snapshot_support:True| | le...| my_type| - | driver_handles_share_servers:False | snapshot_support:True|
+------+--------+-----------+-----------+----------------------------------+----------------------+ +------+--------+-----------+------------------------------------+----------------------+
Create a private share with ``my_type`` share type, NFS shared file system
protocol, and size 1 GB:
.. code:: console
$ manila create nfs 1 --name Share2 --description "My share" --share-type my_type
+-----------------------------+--------------------------------------+
| Property | Value |
+-----------------------------+--------------------------------------+
| status | None |
| share_type_name | my_type |
| description | My share |
| availability_zone | None |
| share_network_id | None |
| export_locations | [] |
| share_server_id | None |
| host | None |
| snapshot_id | None |
| is_public | False |
| task_state | None |
| snapshot_support | True |
| id | bb9f0f28-4ca7-4fcb-a37c-9e3624584bec |
| size | 1 |
| name | Share2 |
| share_type | 1eafb65f-1987-44a9-9a98-20af91c95662 |
| created_at | 2015-10-01T09:44:59.669010 |
| export_location | None |
| share_proto | NFS |
| consistency_group_id | None |
| source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {} |
+-----------------------------+--------------------------------------+
New share ``Share2`` should have a status ``available``:
.. code:: console
$ manila show Share2
+-----------------------------+---------------------------------------------------------------+
| Property | Value |
+-----------------------------+---------------------------------------------------------------+
| status | available |
| share_type_name | my_type |
| description | My share |
| availability_zone | nova |
| share_network_id | None |
| export_locations | 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 |
| share_server_id | None |
| host | manila@cannes#CANNES |
| snapshot_id | None |
| is_public | False |
| task_state | None |
| snapshot_support | True |
| id | bb9f0f28-4ca7-4fcb-a37c-9e3624584bec |
| size | 1 |
| name | Share2 |
| share_type | 1eafb65f-1987-44a9-9a98-20af91c95662 |
| created_at | 2015-10-01T09:44:59.000000 |
| share_proto | NFS |
| consistency_group_id | None |
| source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {} |
+-----------------------------+---------------------------------------------------------------+
.. _create_share_in_share_server_mode:
Create a share in share servers mode
------------------------------------
To create a file share in share servers mode, you need to:
#. To create a share, use :command:`manila create` command and
specify the required arguments: the size of the share and the shared file
system protocol. ``NFS``, ``CIFS``, ``GlusterFS``, or ``HDFS`` share file
system protocols are supported.
#. You should specify the :ref:`share type <shared_file_systems_share_types>`
with ``driver_handles_share_servers = True`` extra specification.
#. You should specify the
:ref:`share network <shared_file_systems_share_networks>`.
#. The :command:`manila create` command creates a share. This command does the
following things:
* The :ref:`manila-scheduler <shared_file_systems_scheduling>` service will
find the back end with ``driver_handles_share_servers = True`` mode due to
filtering the extra specifications of the share type.
* The share driver will create a share server with the share network. For
details of creating the resources, see the `documentation <http://docs.
openstack.org/developer/manila/devref/index.html#share-backends>`_ of the
specific share driver.
#. After the share becomes available, use the :command:`manila show` command
to get the share export location.
In the example to create a share, the default share type and the already
existing share network are used.
.. note::
There is no default share type just after you started manila as the
administrator. See :ref:`shared_file_systems_share_types` to
create the default share type. To create a share network, use
:ref:`shared_file_systems_share_networks`.
Check share types that exist, run:
.. code:: console
$ manila type-list
+------+--------+-----------+-----------+----------------------------------+----------------------+
| ID | Name | Visibility| is_default| required_extra_specs | optional_extra_specs |
+------+--------+-----------+-----------+----------------------------------+----------------------+
| c0...| default| public | YES | driver_handles_share_servers:True| snapshot_support:True|
+------+--------+-----------+-----------+----------------------------------+----------------------+
Check share networks that exist, run: Check share networks that exist, run:
.. code:: console .. code:: console
$ manila share-network-list $ manila share-network-list
+--------------------------------------+--------------+ +--------------------------------------+--------------+
| id | name | | id | name |
+--------------------------------------+--------------+ +--------------------------------------+--------------+
| 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | my_share_net | | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | my_share_net |
+--------------------------------------+--------------+ +--------------------------------------+--------------+
Create a public share with ``my_share_net`` network, ``default`` Create a public share with ``my_share_net`` network, ``default``
share type, NFS shared file system protocol, and size 1 GB: share type, NFS shared file system protocol, and size 1 GB:
.. code:: console .. code:: console
$ manila create nfs 1 --name "Share1" --description "My first share" --share-type default --share-network my_share_net --metadata aim=testing --public $ manila create nfs 1 --name "Share1" --description "My first share" --share-type default --share-network my_share_net --metadata aim=testing --public
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| status | None | | status | None |
| share_type_name | default | | share_type_name | default |
| description | My first share | | description | My first share |
| availability_zone | None | | availability_zone | None |
| share_network_id | None | | share_network_id | None |
| export_locations | [] | | export_locations | [] |
| share_server_id | None | | share_server_id | None |
| host | None | | host | None |
| snapshot_id | None | | snapshot_id | None |
| is_public | True | | is_public | True |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| size | 1 | | size | 1 |
| name | Share1 | | name | Share1 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-24T12:19:06.925951 | | created_at | 2015-09-24T12:19:06.925951 |
| export_location | None | | export_location | None |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'aim': u'testing'} | | metadata | {u'aim': u'testing'} |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
The share also can be created from a share snapshot. For details, see The share also can be created from a share snapshot. For details, see
:ref:`shared_file_systems_snapshots`. :ref:`shared_file_systems_snapshots`.
@ -104,45 +296,45 @@ See the share in a share list:
.. code:: console .. code:: console
$ manila list $ manila list
+----+-------+-----+------------+-----------+-------------------------------+----------------------+ +----+-------+-----+------------+-----------+-------------------------------+----------------------+
| ID | Name | Size| Share Proto| Share Type| Export location | Host | | ID | Name | Size| Share Proto| Share Type| Export location | Host |
+----+-------+-----+------------+-----------+-------------------------------+----------------------+ +----+-------+-----+------------+-----------+-------------------------------+----------------------+
| a..| Share1| 1 | NFS | c0086... | 10.254.0.3:/shares/share-2d5..| manila@generic1#GEN..| | a..| Share1| 1 | NFS | c0086... | 10.254.0.3:/shares/share-2d5..| manila@generic1#GEN..|
+----+-------+-----+------------+-----------+-------------------------------+----------------------+ +----+-------+-----+------------+-----------+-------------------------------+----------------------+
Check the share status and see the share export location. After ``creating`` Check the share status and see the share export location. After ``creating``
status share should have status ``available``: status share should have status ``available``:
.. code:: console .. code:: console
$ manila show Share1 $ manila show Share1
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| status | available | | status | available |
| share_type_name | default | | share_type_name | default |
| description | My first share | | description | My first share |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84... | | export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84... |
| share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 | | share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | None | | snapshot_id | None |
| is_public | True | | is_public | True |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| size | 1 | | size | 1 |
| name | Share1 | | name | Share1 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-24T12:19:06.000000 | | created_at | 2015-09-24T12:19:06.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'aim': u'testing'} | | metadata | {u'aim': u'testing'} |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
``is_public`` defines the level of visibility for the share: whether other ``is_public`` defines the level of visibility for the share: whether other
tenants can or cannot see the share. By default, the share is private. tenants can or cannot see the share. By default, the share is private.
@ -155,35 +347,35 @@ the share if you need:
.. code:: console .. code:: console
$ manila update Share1 --description "My first share. Updated" --is-public False $ manila update Share1 --description "My first share. Updated" --is-public False
$ manila show Share1 $ manila show Share1
+-----------------------------+--------------------------------------------+ +-----------------------------+--------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+--------------------------------------------+ +-----------------------------+--------------------------------------------+
| status | available | | status | available |
| share_type_name | default | | share_type_name | default |
| description | My first share. Updated | | description | My first share. Updated |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84-... | | export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84-... |
| share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 | | share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| size | 1 | | size | 1 |
| name | Share1 | | name | Share1 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-24T12:19:06.000000 | | created_at | 2015-09-24T12:19:06.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'aim': u'testing'} | | metadata | {u'aim': u'testing'} |
+-----------------------------+--------------------------------------------+ +-----------------------------+--------------------------------------------+
A share can have one of these status values: A share can have one of these status values:
@ -233,31 +425,31 @@ If you want to set the metadata key-value pairs on the share, run:
.. code:: console .. code:: console
$ manila metadata Share1 set project=my_abc deadline=01/20/16 $ manila metadata Share1 set project=my_abc deadline=01/20/16
Get all metadata key-value pairs of the share: Get all metadata key-value pairs of the share:
.. code:: console .. code:: console
$ manila metadata-show Share1 $ manila metadata-show Share1
+----------+----------+ +----------+----------+
| Property | Value | | Property | Value |
+----------+----------+ +----------+----------+
| aim | testing | | aim | testing |
| project | my_abc | | project | my_abc |
| deadline | 01/20/16 | | deadline | 01/20/16 |
+----------+----------+ +----------+----------+
You can update the metadata: You can update the metadata:
.. code:: console .. code:: console
$ manila metadata-update-all Share1 deadline=01/30/16 $ manila metadata-update-all Share1 deadline=01/30/16
+----------+----------+ +----------+----------+
| Property | Value | | Property | Value |
+----------+----------+ +----------+----------+
| deadline | 01/30/16 | | deadline | 01/30/16 |
+----------+----------+ +----------+----------+
You also can unset the metadata using You also can unset the metadata using
**manila metadata <share_name> unset <metadata_key(s)>**. **manila metadata <share_name> unset <metadata_key(s)>**.
@ -274,36 +466,36 @@ include ``available``, ``error``, ``creating``, ``deleting``,
.. code:: console .. code:: console
$ manila reset-state Share2 --state deleting $ manila reset-state Share2 --state deleting
$ manila show Share2 $ manila show Share2
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| status | deleting | | status | deleting |
| share_type_name | default | | share_type_name | default |
| description | Share from a snapshot. | | description | Share from a snapshot. |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| export_locations | [] | | export_locations | [] |
| share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 | | share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd | | snapshot_id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | b6b0617c-ea51-4450-848e-e7cff69238c7 | | id | b6b0617c-ea51-4450-848e-e7cff69238c7 |
| size | 1 | | size | 1 |
| name | Share2 | | name | Share2 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-25T06:25:50.000000 | | created_at | 2015-09-25T06:25:50.000000 |
| export_location | 10.254.0.3:/shares/share-1dc2a471-3d47-...| | export_location | 10.254.0.3:/shares/share-1dc2a471-3d47-...|
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'source': u'snapshot'} | | metadata | {u'source': u'snapshot'} |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
Delete and force-delete share Delete and force-delete share
----------------------------- -----------------------------
@ -312,22 +504,27 @@ You also can force-delete a share.
The shares cannot be deleted in transitional states. The transitional The shares cannot be deleted in transitional states. The transitional
states are ``creating``, ``deleting``, ``managing``, ``unmanaging``, states are ``creating``, ``deleting``, ``managing``, ``unmanaging``,
``extending``, and ``shrinking`` statuses for the shares. Force-deletion ``extending``, and ``shrinking`` statuses for the shares. Force-deletion
deletes an object in any state. Use the :file:`/etc/manila/policy.json` file to deletes an object in any state. Use the :file:`policy.json` file to grant
grant permissions for this action to other roles. permissions for this action to other roles.
.. tip::
The configuration file ``policy.json`` may be used from different places.
The path ``/etc/manila/policy.json`` is one of expected paths by default.
Use **manila delete <share_name_or_ID>** command to delete a specified share: Use **manila delete <share_name_or_ID>** command to delete a specified share:
.. code:: console .. code:: console
$ manila delete Share2 $ manila delete Share2
Pay attention that if you specified the consistency group while creating a .. note::
share (see :ref:`shared_file_systems_cgroups`), you If you specified :ref:`the consistency group <shared_file_systems_cgroups>`
should provide the ``--consistency-group`` parameter to delete the share: while creating a share, you should provide the ``--consistency-group``
parameter to delete the share:
.. code:: console .. code:: console
$ manila delete ba52454e-2ea3-47fa-a683-3176a01295e6 --consistency-group ffee08d9-c86c-45e5-861e-175c731daca2 $ manila delete ba52454e-2ea3-47fa-a683-3176a01295e6 --consistency-group ffee08d9-c86c-45e5-861e-175c731daca2
If you try to delete the share in one of the transitional If you try to delete the share in one of the transitional
@ -335,9 +532,9 @@ state using soft-deletion you'll get an error:
.. code:: console .. code:: console
$ manila delete b6b0617c-ea51-4450-848e-e7cff69238c7 $ manila delete b6b0617c-ea51-4450-848e-e7cff69238c7
Delete for share b6b0617c-ea51-4450-848e-e7cff69238c7 failed: Invalid share: Share status must be one of ('available', 'error', 'inactive'). (HTTP 403) (Request-ID: req-9a77b9a0-17d2-4d97-8a7a-b7e23c27f1fe) Delete for share b6b0617c-ea51-4450-848e-e7cff69238c7 failed: Invalid share: Share status must be one of ('available', 'error', 'inactive'). (HTTP 403) (Request-ID: req-9a77b9a0-17d2-4d97-8a7a-b7e23c27f1fe)
ERROR: Unable to delete any of the specified shares. ERROR: Unable to delete any of the specified shares.
A share cannot be deleted in a transitional status, that it why an error from A share cannot be deleted in a transitional status, that it why an error from
``python-manilaclient`` appeared. ``python-manilaclient`` appeared.
@ -346,33 +543,35 @@ Print the list of all shares for all tenants:
.. code:: console .. code:: console
$ manila list --all-tenants $ manila list --all-tenants
+------+-------+-----+------------+-------+-----------+-----------------------------+-------------+ +------+-------+-----+------------+-------+-----------+-----------------------------+-------------+
| ID | Name | Size| Share Proto| Status| Share Type| Export location | Host | | ID | Name | Size| Share Proto| Status| Share Type| Export location | Host |
+------+-------+-----+------------+-------+-----------+-----------------------------+-------------+ +------+-------+-----+------------+-------+-----------+-----------------------------+-------------+
| aca..| Share1| 1 | NFS | avai..| c008658...| 10.254.0.3:/shares/share-...| manila@gen..| | aca..| Share1| 1 | NFS | avai..| c008658...| 10.254.0.3:/shares/share-...| manila@gen..|
| b6b..| Share2| 1 | NFS | dele..| c008658...| 10.254.0.3:/shares/share-...| manila@gen..| | b6b..| Share2| 1 | NFS | dele..| c008658...| 10.254.0.3:/shares/share-...| manila@gen..|
+------+-------+-----+------------+-------+-----------+-----------------------------+-------------+ +------+-------+-----+------------+-------+-----------+-----------------------------+-------------+
Force-delete Share2 and check that it is absent in the list of shares, Force-delete Share2 and check that it is absent in the list of shares,
run: run:
.. code:: console .. code:: console
$ manila force-delete b6b0617c-ea51-4450-848e-e7cff69238c7 $ manila force-delete b6b0617c-ea51-4450-848e-e7cff69238c7
$ manila list $ manila list
+------+-------+-----+------------+-------+-----------+-----------------------------+-------------+ +------+-------+-----+------------+-------+-----------+-----------------------------+-------------+
| ID | Name | Size| Share Proto| Status| Share Type| Export location | Host | | ID | Name | Size| Share Proto| Status| Share Type| Export location | Host |
+------+-------+-----+------------+-------+-----------+-----------------------------+-------------+ +------+-------+-----+------------+-------+-----------+-----------------------------+-------------+
| aca..| Share1| 1 | NFS | avai..| c008658...| 10.254.0.3:/shares/share-...| manila@gen..| | aca..| Share1| 1 | NFS | avai..| c008658...| 10.254.0.3:/shares/share-...| manila@gen..|
+------+-------+-----+------------+-------+-----------+-----------------------------+-------------+ +------+-------+-----+------------+-------+-----------+-----------------------------+-------------+
.. _access_to_share:
Manage access to share Manage access to share
---------------------- ----------------------
The Shared File Systems Storage Service allows to grant or deny access to The Shared File Systems service allows to grant or deny access to a specified
a specified share, and list the permissions for a specified share. share, and list the permissions for a specified share.
To grant or deny access to a share, specify one of these supported share To grant or deny access to a share, specify one of these supported share
access levels: access levels:
@ -401,11 +600,11 @@ node with IP address ``10.254.0.4``:
.. code:: console .. code:: console
$ sudo mount -v -t nfs 10.254.0.5:/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a /mnt/ $ sudo mount -v -t nfs 10.254.0.5:/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a /mnt/
mount.nfs: timeout set for Tue Oct 6 10:37:23 2015 mount.nfs: timeout set for Tue Oct 6 10:37:23 2015
mount.nfs: trying text-based options 'vers=4,addr=10.254.0.5,clientaddr=10.254.0.4' mount.nfs: trying text-based options 'vers=4,addr=10.254.0.5,clientaddr=10.254.0.4'
mount.nfs: mount(2): Permission denied mount.nfs: mount(2): Permission denied
mount.nfs: access denied by server while mounting 10.254.0.5:/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a mount.nfs: access denied by server while mounting 10.254.0.5:/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a
An error message "Permission denied" appeared, so you are not allowed to mount An error message "Permission denied" appeared, so you are not allowed to mount
a share without an access rule. Allow access to the share with ``ip`` access a share without an access rule. Allow access to the share with ``ip`` access
@ -413,46 +612,46 @@ type and ``10.254.0.4`` IP address:
.. code:: console .. code:: console
$ manila access-allow Share2 ip 10.254.0.4 --access-level rw $ manila access-allow Share2 ip 10.254.0.4 --access-level rw
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| Property | Value | | Property | Value |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| share_id | 7bcd888b-681b-4836-ac9c-c3add4e62537 | | share_id | 7bcd888b-681b-4836-ac9c-c3add4e62537 |
| access_type | ip | | access_type | ip |
| access_to | 10.254.0.4 | | access_to | 10.254.0.4 |
| access_level | rw | | access_level | rw |
| state | new | | state | new |
| id | de715226-da00-4cfc-b1ab-c11f3393745e | | id | de715226-da00-4cfc-b1ab-c11f3393745e |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
Try to mount a share again. This time it is mounted successfully: Try to mount a share again. This time it is mounted successfully:
.. code:: console .. code:: console
$ sudo mount -v -t nfs 10.254.0.5:/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a /mnt/ $ sudo mount -v -t nfs 10.254.0.5:/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a /mnt/
Since it is allowed node on 10.254.0.4 read and write access, try to create Since it is allowed node on 10.254.0.4 read and write access, try to create
a file on a mounted share: a file on a mounted share:
.. code:: console .. code:: console
$ cd /mnt $ cd /mnt
$ ls $ ls
lost+found lost+found
$ touch my_file.txt $ touch my_file.txt
Connect via SSH to the 10.254.0.5 node and check new file `my_file.txt` Connect via SSH to the 10.254.0.5 node and check new file `my_file.txt`
in the ``/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a`` directory: in the ``/shares/share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a`` directory:
.. code:: console .. code:: console
$ ssh manila@10.254.0.5 $ ssh manila@10.254.0.5
$ cd /shares $ cd /shares
$ ls $ ls
share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a
$ cd share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a $ cd share-5789ddcf-35c9-4b64-a28a-7f6a4a574b6a
$ ls $ ls
lost+found my_file.txt lost+found my_file.txt
You have successfully created a file from instance that was given access by You have successfully created a file from instance that was given access by
its IP address. its IP address.
@ -461,50 +660,49 @@ Allow access to the share with ``user`` access type:
.. code:: console .. code:: console
$ manila access-allow Share2 user demo --access-level rw $ manila access-allow Share2 user demo --access-level rw
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| Property | Value | | Property | Value |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| share_id | 7bcd888b-681b-4836-ac9c-c3add4e62537 | | share_id | 7bcd888b-681b-4836-ac9c-c3add4e62537 |
| access_type | user | | access_type | user |
| access_to | demo | | access_to | demo |
| access_level | rw | | access_level | rw |
| state | new | | state | new |
| id | 4f391c6b-fb4f-47f5-8b4b-88c5ec9d568a | | id | 4f391c6b-fb4f-47f5-8b4b-88c5ec9d568a |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
.. note:: .. note::
Different share features are supported by different share drivers. Different share features are supported by different share drivers.
For the example hereinabove was used the Generic (Cinder as back-end) For the example, the Generic driver with the Block Storage service as a
driver that doesn't support ``user`` and ``cert`` authentications methods. back-end doesn't support ``user`` and ``cert`` authentications methods. For
For details of supporting of features by different drivers, see `Manila details of supporting of features by different drivers, see `Manila share
share features support mapping features support mapping <http://docs.openstack.org/developer/manila/devref
<http://docs.openstack.org/developer/manila/devref/share_back_ends_feature /share_back_ends_feature_support_mapping.html>`_.
_support_mapping.html>`_.
To verify that the access rules (ACL) were configured correctly for a share, To verify that the access rules (ACL) were configured correctly for a share,
you list permissions for a share: you list permissions for a share:
.. code:: console .. code:: console
$ manila access-list Share2 $ manila access-list Share2
+--------------------------------------+-------------+------------+--------------+--------+ +--------------------------------------+-------------+------------+--------------+--------+
| id | access type | access to | access level | state | | id | access type | access to | access level | state |
+--------------------------------------+-------------+------------+--------------+--------+ +--------------------------------------+-------------+------------+--------------+--------+
| 4f391c6b-fb4f-47f5-8b4b-88c5ec9d568a | user | demo | rw | error | | 4f391c6b-fb4f-47f5-8b4b-88c5ec9d568a | user | demo | rw | error |
| de715226-da00-4cfc-b1ab-c11f3393745e | ip | 10.254.0.4 | rw | active | | de715226-da00-4cfc-b1ab-c11f3393745e | ip | 10.254.0.4 | rw | active |
+--------------------------------------+-------------+------------+--------------+--------+ +--------------------------------------+-------------+------------+--------------+--------+
Deny access to the share and check that deleted access rule is absent in the Deny access to the share and check that deleted access rule is absent in the
access rule list: access rule list:
.. code:: console .. code:: console
$ manila access-deny Share2 de715226-da00-4cfc-b1ab-c11f3393745e $ manila access-deny Share2 de715226-da00-4cfc-b1ab-c11f3393745e
$ manila access-list Share2 $ manila access-list Share2
+--------------------------------------+-------------+-----------+--------------+-------+ +--------------------------------------+-------------+-----------+--------------+-------+
| id | access type | access to | access level | state | | id | access type | access to | access level | state |
+--------------------------------------+-------------+-----------+--------------+-------+ +--------------------------------------+-------------+-----------+--------------+-------+
| 4f391c6b-fb4f-47f5-8b4b-88c5ec9d568a | user | demo | rw | error | | 4f391c6b-fb4f-47f5-8b4b-88c5ec9d568a | user | demo | rw | error |
+--------------------------------------+-------------+-----------+--------------+-------+ +--------------------------------------+-------------+-----------+--------------+-------+

16
doc/admin-guide-cloud/source/shared_file_systems_key_concepts.rst
View File

@ -10,8 +10,8 @@ Share
In the Shared File Systems service ``share`` is the fundamental resource unit In the Shared File Systems service ``share`` is the fundamental resource unit
allocated by the Shared File System service. It represents an allocation of a allocated by the Shared File System service. It represents an allocation of a
persistent, readable, and writable filesystem that can be accessed by persistent, readable, and writable filesystem that can be accessed by
OpenStack compute instances, or clients outside of OpenStack (depending on OpenStack compute instances, or clients outside of OpenStack, which depends on
deployment configuration). deployment configuration.
.. note:: .. note::
A ``share`` is an abstract storage object that may or may not directly A ``share`` is an abstract storage object that may or may not directly
@ -51,7 +51,7 @@ Share Access Rules
``Share access rules`` define which users can access a particular ``share``. ``Share access rules`` define which users can access a particular ``share``.
For example, access rules can be declared for NFS shares by listing the valid For example, access rules can be declared for NFS shares by listing the valid
IP networks (using CIDR notation) which should have access to the ``share``. IP networks, in CIDR notation, which should have access to the ``share``.
Security Services Security Services
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
@ -68,13 +68,19 @@ Share Networks
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~
A ``share network`` is an object that defines a relationship between a A ``share network`` is an object that defines a relationship between a
tenant's network/subnet (as defined in an OpenStack network service (Neutron tenant's network and subnet, as defined in an OpenStack Networking service or
or Nova-network)) and the ``shares`` created by the same tenant; that is, a Compute service, and the ``shares`` created by the same tenant; that is, a
tenant may find it desirable to provision ``shares`` such that only instances tenant may find it desirable to provision ``shares`` such that only instances
connected to a particular OpenStack-defined network have access to the connected to a particular OpenStack-defined network have access to the
``share``. Also, ``security services`` can be attached to ``share networks``, ``share``. Also, ``security services`` can be attached to ``share networks``,
because most of auth protocols require some interaction with network services. because most of auth protocols require some interaction with network services.
The Shared File Systems service has the ability to work outside of OpenStack.
That is due to the ``StandaloneNetworkPlugin`` that can be used with any
network platform and does not require some specific network services in
OpenStack like Compute or Networking service. You can set the network
parameters in its configuration file.
Share Servers Share Servers
~~~~~~~~~~~~~ ~~~~~~~~~~~~~

158
doc/admin-guide-cloud/source/shared_file_systems_manage_and_unmanage_share.rst
View File

@ -6,50 +6,47 @@ Manage and unmanage share
To ``manage`` a share means that an administrator rather than a share driver To ``manage`` a share means that an administrator rather than a share driver
manages the storage life cycle. This approach is appropriate when an manages the storage life cycle. This approach is appropriate when an
administrator already has the custom non-manila share with its size, Shared administrator already has the custom non-manila share with its size, shared
File System protocol, export path and so on, and administrator wants to file system protocol, export path and so on, and administrator wants to
register it in the Shared File System Storage service. register it in the Shared File System service.
To ``unmanage`` a share means to unregister a specified share from the Shared To ``unmanage`` a share means to unregister a specified share from the Shared
File System Storage service. An administrator can manage the custom share back. File Systems service. An administrator can manage the custom share back.
Since with the generic driver, shares are hosted on Compute VMs, in the
examples the compute VM is used to create a new host and to create a share
hosted on it.
.. _unmanage_share: .. _unmanage_share:
Unmanage share Unmanage share
-------------- --------------
You can ``unmanage`` share, to take manual control on share life cycle. The You can ``unmanage`` a share, to unregister it from the Shared File System
``unmanage`` operation is not supported for shares that were created on top of service, and take manual control on share life cycle. The ``unmanage``
share servers (created with share networks), so share service should have operation is not supported for shares that were created on top of share servers
option ``driver_handles_share_servers = False`` in its configuration. and created with share networks), so share service should have option
You can unmanage a share that has no dependent snapshots. ``driver_handles_share_servers = False`` in its configuration. You can unmanage
a share that has no dependent snapshots.
To unmanage managed share, run :command:`manila unmanage <share>` command. To unmanage managed share, run :command:`manila unmanage <share>` command.
Then try to print the information about it. The expected behaviour is that Then try to print the information about it. The expected behaviour is that
File System Storage service won't find the share: Shared File Systems service won't find the share:
.. code:: console .. code:: console
$ manila unmanage Share3 $ manila unmanage Share3
$ manila show Share3 $ manila show Share3
ERROR: No share with a name or ID of 'Share3' exists. ERROR: No share with a name or ID of 'Share3' exists.
.. _manage_share: .. _manage_share:
Manage share Manage share
------------ ------------
To register the non-managed share in File System Storage service you need to To register the non-managed share in File System service you need to run
run :command:`manila manage` command which has such arguments: :command:`manila manage` command which has such arguments:
.. code:: console .. code:: console
manila manage [--name <name>] [--description <description>] manila manage [--name <name>] [--description <description>]
[--share_type <share-type>] [--share_type <share-type>]
[--driver_options [<key=value> [<key=value> ...]]] [--driver_options [<key=value> [<key=value> ...]]]
<service_host> <protocol> <export_path> <service_host> <protocol> <export_path>
The positional arguments are: The positional arguments are:
@ -67,6 +64,9 @@ The positional arguments are:
- CIFS protocol. \\\\10.0.0.1\\foo_name_of_cifs_share. - CIFS protocol. \\\\10.0.0.1\\foo_name_of_cifs_share.
- HDFS protocol. hdfs://10.0.0.1:foo_port/foo_share_name.
- GlusterFS. 10.0.0.1:/foo_volume.
The ``driver_options`` is an optional set of one or more key and value pairs, The ``driver_options`` is an optional set of one or more key and value pairs,
that describe driver options. Note that the share type must have that describe driver options. Note that the share type must have
@ -77,63 +77,63 @@ To manage share, run:
.. code:: console .. code:: console
$ manila manage manila@cannes#CANNES nfs 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 --name Share --description "We manage share." --share_type for_managing $ manila manage manila@cannes#CANNES nfs 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 --name Share --description "We manage share." --share_type for_managing
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
| status | manage_starting | | status | manage_starting |
| share_type_name | for_managing | | share_type_name | for_managing |
| description | We manage share. | | description | We manage share. |
| availability_zone | None | | availability_zone | None |
| share_network_id | None | | share_network_id | None |
| export_locations | [] | | export_locations | [] |
| share_server_id | None | | share_server_id | None |
| host | manila@cannes#CANNES | | host | manila@cannes#CANNES |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | 5c1f644a-6521-4699-b480-b03d17e2d21d | | id | 5c1f644a-6521-4699-b480-b03d17e2d21d |
| size | None | | size | None |
| name | Share3 | | name | Share3 |
| share_type | 1eafb65f-1987-44a9-9a98-20af91c95662 | | share_type | 1eafb65f-1987-44a9-9a98-20af91c95662 |
| created_at | 2015-10-01T10:35:52.000000 | | created_at | 2015-10-01T10:35:52.000000 |
| export_location | 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 | | export_location | 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {} | | metadata | {} |
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
Check that he share is available: Check that the share is available:
.. code:: console .. code:: console
$ manila show Share $ manila show Share
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+
| status | available | | status | available |
| share_type_name | for_managing | | share_type_name | for_managing |
| description | We manage share. | | description | We manage share. |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | None | | share_network_id | None |
| export_locations | 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 | | export_locations | 10.254.0.7:/shares/share-d1a66eed-a724-4cbb-a886-2f97926bd3b3 |
| share_server_id | None | | share_server_id | None |
| host | manila@cannes#CANNES | | host | manila@cannes#CANNES |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | 5c1f644a-6521-4699-b480-b03d17e2d21d | | id | 5c1f644a-6521-4699-b480-b03d17e2d21d |
| size | 1 | | size | 1 |
| name | Share3 | | name | Share3 |
| share_type | 1eafb65f-1987-44a9-9a98-20af91c95662 | | share_type | 1eafb65f-1987-44a9-9a98-20af91c95662 |
| created_at | 2015-10-01T10:35:52.000000 | | created_at | 2015-10-01T10:35:52.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {} | | metadata | {} |
+-----------------------------+---------------------------------------------------------------+ +-----------------------------+---------------------------------------------------------------+

78
doc/admin-guide-cloud/source/shared_file_systems_multi_backend.rst
View File

@ -1,63 +1,59 @@
.. _shared_file_systems_multi_backend: .. _shared_file_systems_multi_backend:
.. highlight: ini
:linenothreshold: 5
=========================== ===========================
Multi-storage configuration Multi-storage configuration
=========================== ===========================
Shared File Systems service can provide access to multiple file storage back The Shared File Systems service can provide access to multiple file storage
ends. In general, workflow with multiple back ends look very similar to Block back ends. In general, the workflow with multiple back ends looks very similar
Storage service one, see :ref:`Configure multiple-storage back ends in to the Block Storage service one, see :ref:`Configure multiple-storage back
Openstack Block Storage service <multi_backend>`. ends in Openstack Block Storage service <multi_backend>`.
Using `manila.conf` you can spawn multiple share services. To do it, you must Using `manila.conf`, you can spawn multiple share services. To do it, you
set the `enabled_share_backends` flag in the `manila.conf` file. This flag should set the `enabled_share_backends` flag in the `manila.conf` file. This
defines the names (separated by a comma) of the configuration stanzas for the flag defines the comma-separated names of the configuration stanzas for the
different back ends: one name is associated to one configuration group for a different back ends: one name is associated to one configuration group for a
back end. back end.
The following example runs three configured share services: The following example runs three configured share services:
.. code-block:: ini .. code-block:: ini
:linenos: :linenos:
[DEFAULT] [DEFAULT]
enabled_share_backends=backendEMC1,backendEMC2,backendGeneric1,backendGeneric2,backendNetApp enabled_share_backends=backendEMC2,backendGeneric1,backendNetApp
[backendGeneric1] [backendGeneric1]
share_driver=manila.share.drivers.generic.GenericShareDriver share_driver=manila.share.drivers.generic.GenericShareDriver
share_backend_name=one_name_for_two_backends share_backend_name=one_name_for_two_backends
service_instance_user=ubuntu_user service_instance_user=ubuntu_user
service_instance_password=ubuntu_user_password service_instance_password=ubuntu_user_password
service_image_name=ubuntu_image_name service_image_name=ubuntu_image_name
path_to_private_key=/home/foouser/.ssh/id_rsa path_to_private_key=/home/foouser/.ssh/id_rsa
path_to_public_key=/home/foouser/.ssh/id_rsa.pub path_to_public_key=/home/foouser/.ssh/id_rsa.pub
[backendEMC2] [backendEMC2]
share_driver=manila.share.drivers.emc.driver.EMCShareDriver share_driver=manila.share.drivers.emc.driver.EMCShareDriver
share_backend_name=backendEMC2 share_backend_name=backendEMC2
emc_share_backend=vnx emc_share_backend=vnx
emc_nas_server=1.1.1.1 emc_nas_server=1.1.1.1
emc_nas_password=password emc_nas_password=password
emc_nas_login=user emc_nas_login=user
emc_nas_server_container=server_3 emc_nas_server_container=server_3
emc_nas_pool_name="Pool 2" emc_nas_pool_name="Pool 2"
[backendNetApp] [backendNetApp]
share_driver = manila.share.drivers.netapp.common.NetAppDriver share_driver = manila.share.drivers.netapp.common.NetAppDriver
driver_handles_share_servers = True driver_handles_share_servers = True
share_backend_name=backendNetApp share_backend_name=backendNetApp
netapp_login=user netapp_login=user
netapp_password=password netapp_password=password
netapp_server_hostname=1.1.1.1 netapp_server_hostname=1.1.1.1
netapp_root_volume_aggregate=aggr01 netapp_root_volume_aggregate=aggr01
To spawn separate groups of share services you can use separate configuration To spawn separate groups of share services, you can use separate configuration
files. If it is necessary to control each back end in separate way, you should files. If it is necessary to control each back end in a separate way, you
provide a single configuration file per each back end. should provide a single configuration file per each back end.
.. toctree:: .. toctree::
shared_file_systems_scheduling.rst shared_file_systems_scheduling.rst

72
doc/admin-guide-cloud/source/shared_file_systems_network_plugins.rst
View File

@ -7,73 +7,77 @@ Network plug-ins
The Shared File Systems service architecture defines an abstraction layer for The Shared File Systems service architecture defines an abstraction layer for
network resource provisioning and allowing administrators to choose from a network resource provisioning and allowing administrators to choose from a
different options for how network resources are assigned to their tenants’ different options for how network resources are assigned to their tenants’
networked storage. There are a set of network plugins that provide a variety networked storage. There are a set of network plug-ins that provide a variety
of integration approaches with the network services that are available with of integration approaches with the network services that are available with
OpenStack. OpenStack.
The Shared File Systems service may need a network resource provisioning if The Shared File Systems service may need a network resource provisioning if
share service with specified driver works in mode, when share driver manage share service with specified driver works in mode, when a share driver manages
life cycle of share servers on its own. This behavior defines by flag life cycle of share servers on its own. This behavior is defined by a flag
``driver_handles_share_servers`` in share service configuration. When ``driver_handles_share_servers`` in share service configuration. When
``driver_handles_share_servers`` is set to ``True``, a share driver will be ``driver_handles_share_servers`` is set to ``True``, a share driver will be
called to create share servers for shares using information provided within a called to create share servers for shares using information provided within a
share network. This information will be provided to one of the enabled network share network. This information will be provided to one of the enabled network
plugins that will handle reservation, creation and deletion of network plug-ins that will handle reservation, creation and deletion of network
resources including IP addresses and network interfaces. resources including IP addresses and network interfaces.
What network plugins are available? What network plug-ins are available?
----------------------------------- ------------------------------------
There are three different network plugins and five python classes in Manila: There are three different network plug-ins and five python classes in the
Shared File Systems service:
1. Network plugin for using the OpenStack networking project `Neutron`. It #. Network plug-in for using the OpenStack Networking service. It allows to use
allows one to use any network segmentation that Neutron supports. It is up any network segmentation that the Networking service supports. It is up to
to each share driver to support at least one network segmentation type. each share driver to support at least one network segmentation type.
a) ``manila.network.neutron.neutron_network_plugin.NeutronNetworkPlugin``. a) ``manila.network.neutron.neutron_network_plugin.NeutronNetworkPlugin``.
This is the default network plugin. It requires that ``neutron_net_id`` This is a default network plug-in. It requires the ``neutron_net_id`` and
and ``neutron_subnet_id`` are provided when defining the share network the ``neutron_subnet_id`` to be provided when defining the share network
that will be used for the creation of share servers. The user may that will be used for the creation of share servers. The user may define
define any number of share networks corresponding to the various any number of share networks corresponding to the various physical
physical network segments in a tenant environment. network segments in a tenant environment.
b) ``manila.network.neutron.neutron_network_plugin.NeutronSingleNetworkPlug b) ``manila.network.neutron.neutron_network_plugin.
in``. This is a simplification of the previous case. It accepts values NeutronSingleNetworkPlugin``. This is a simplification of the previous
for ``neutron_net_id`` and ``neutron_subnet_id`` from the Manila case. It accepts values for ``neutron_net_id`` and ``neutron_subnet_id``
configuration file and uses one network for all shares. from the ``manila.conf`` configuration file and uses one network for all
shares.
When only a single network is needed, the NeutronSingleNetworkPlugin (1.b) When only a single network is needed, the NeutronSingleNetworkPlugin (1.b)
is a simple solution. Otherwise NeutronNetworkPlugin (1.a) should be chosen. is a simple solution. Otherwise NeutronNetworkPlugin (1.a) should be chosen.
2. Network plugin for working with OpenStack networking from `Nova`. It #. Network plug-in for working with OpenStack Networking from the Compute
supports either flat networks or VLAN-segmented networks. service. It supports either flat networks or VLAN-segmented networks.
a) ``manila.network.nova_network_plugin.NovaNetworkPlugin``. This plugin a) ``manila.network.nova_network_plugin.NovaNetworkPlugin``. This plug-in
serves the networking needs when ``Nova networking`` is configured in serves the networking needs when ``Nova networking`` is configured in
the cloud instead of Neutron. It requires a single parameter, the cloud instead of Neutron. It requires a single parameter,
``nova_net_id``. ``nova_net_id``.
b) ``manila.network.nova_network_plugin.NovaSingleNetworkPlugin``. This one b) ``manila.network.nova_network_plugin.NovaSingleNetworkPlugin``. This
works in the same way as the previous one with one difference. It takes plug-in works the same way as
nova_net_id from the Shared File Systems service configuration file and ``manila.network.nova_network_plugin.NovaNetworkPlugin``, except it takes
creates share servers using only one network. ``nova_net_id`` from the Shared File Systems service configuration
file and creates the share servers using only one network.
When only a single network is needed, the NovaSingleNetworkPlugin (2.b) is a When only a single network is needed, the NovaSingleNetworkPlugin (2.b) is a
simple solution. Otherwise NovaNetworkPlugin (1.a) should be chosen. simple solution. Otherwise NovaNetworkPlugin (2.a) should be chosen.
3. Network plugin for specifying networks independently from OpenStack #. Network plug-in for specifying networks independently from OpenStack
networking services. networking services.
a) ``manila.network.standalone_network_plugin.StandaloneNetworkPlugin``. a) ``manila.network.standalone_network_plugin.StandaloneNetworkPlugin``.
This plug-in uses a pre-existing network that is available to the This plug-in uses a pre-existing network that is available to the
manila-share host. This network may be handled either by OpenStack or be manila-share host. This network may be handled either by OpenStack or be
created independently by any other means. The plugin supports any type of created independently by any other means. The plug-in supports any type
network - flat and segmented. As above, it is completely up to the driver of network - flat and segmented. As above, it is completely up to the
to support the network type for which the network plugin is configured. share driver to support the network type for which the network plug-in is
configured.
.. note:: .. note::
These network plugins were introduced in the OpenStack Kilo release. In These network plug-ins were introduced in the OpenStack Kilo release. In
the OpenStack Juno version, only NeutronNetworkPlugin is available. the OpenStack Juno version, only NeutronNetworkPlugin is available.
More information about network plugins can be found in `Manila developer documentation <http://docs.openstack.org/developer/manila/adminref/network_plugins.html>`_ More information about network plug-ins can be found in `Manila developer documentation <http://docs.openstack.org/developer/manila/adminref/network_plugins.html>`_

14
doc/admin-guide-cloud/source/shared_file_systems_networking.rst
View File

@ -4,13 +4,13 @@
Networking Networking
========== ==========
Instead of OpenStack Block Storage service, Shared File Systems service Unlike the OpenStack Block Storage service, the Shared File Systems service
requires interaction with Networking service. The first of all, it because requires interaction with the Networking service. First of all, it is because
share services should have a possibility to manage share servers on its own. the share services require the option to self-manage share servers. Also, for
Also, lots of shared file systems provides have own access control systems and authentication and authorization of the clients, the Shared File Systems
requires network connectivity with some external auth providers, like LDAP, service can be optionally configured to work with different network
Kerberos, or Microsoft Active Directory. So, management share services base authentication services, like LDAP, Kerberos protocols, or Microsoft Active
on such back end needs some interacting with Networking service. Directory.
.. toctree:: .. toctree::
shared_file_systems_share_networks.rst shared_file_systems_share_networks.rst

142
doc/admin-guide-cloud/source/shared_file_systems_quotas.rst
View File

@ -8,43 +8,29 @@ Limits
------ ------
Limits are the resource limitations that are allowed for each tenant (project). Limits are the resource limitations that are allowed for each tenant (project).
An administrator can configure limits in the :file:`/etc/manila/manila.conf` An administrator can configure limits in the :file:`manila.conf` file.
file.
Users can query their rate and absolute limits. Users can query their rate and absolute limits.
The absolute limits contain information about:
- Total maximum share memory, in GBs.
- Total maximum snapshot memory, in GBs.
- Number of share-networks.
- Number of share-snapshots.
- Number of shares.
- Shares and total used memory, in GBs.
To see the absolute limits, run: To see the absolute limits, run:
.. code:: console .. code:: console
$ manila absolute-limits $ manila absolute-limits
+----------------------------+-------+ +----------------------------+-------+
| Name | Value | | Name | Value |
+----------------------------+-------+ +----------------------------+-------+
| maxTotalShareGigabytes | 1000 | | maxTotalShareGigabytes | 1000 |
| maxTotalShareNetworks | 10 | | maxTotalShareNetworks | 10 |
| maxTotalShareSnapshots | 50 | | maxTotalShareSnapshots | 50 |
| maxTotalShares | 50 | | maxTotalShares | 50 |
| maxTotalSnapshotGigabytes | 1000 | | maxTotalSnapshotGigabytes | 1000 |
| totalShareGigabytesUsed | 1 | | totalShareGigabytesUsed | 1 |
| totalShareNetworksUsed | 2 | | totalShareNetworksUsed | 2 |
| totalShareSnapshotsUsed | 1 | | totalShareSnapshotsUsed | 1 |
| totalSharesUsed | 1 | | totalSharesUsed | 1 |
| totalSnapshotGigabytesUsed | 1 | | totalSnapshotGigabytesUsed | 1 |
+----------------------------+-------+ +----------------------------+-------+
Rate limits control the frequency at which users can issue specific API Rate limits control the frequency at which users can issue specific API
requests. Administrators use rate limiting to configure limits on the type and requests. Administrators use rate limiting to configure limits on the type and
@ -52,11 +38,39 @@ number of API calls that can be made in a specific time interval. For example,
a rate limit can control the number of GET requests that can be processed a rate limit can control the number of GET requests that can be processed
during a one-minute period. during a one-minute period.
To set the API rate limits, add configuration to the
:file:`etc/manila/api-paste.ini` file that is a part of the WSGI pipeline and
defines the actual limits. You need to restart ``manila-api`` service after
you edited :file:`etc/manila/api-paste.ini` file.
.. code-block:: ini
[filter:ratelimit]
paste.filter_factory = manila.api.v1.limits:RateLimitingMiddleware.factory
limits = (POST, "*/shares", ^/shares, 120, MINUTE);(PUT, "*/shares", .*, 120, MINUTE);(DELETE, "*", .*, 120, MINUTE)
Also, add ``ratelimit`` to ``noauth``, ``keystone``, ``keystone_nolimit``
parameters in ``[composite:openstack_share_api]`` group.
.. code-block:: ini
[composite:openstack_share_api]
noauth = faultwrap ssl ratelimit sizelimit noauth api
keystone = faultwrap ssl ratelimit sizelimit authtoken keystonecontext api
keystone_nolimit = faultwrap ssl ratelimit sizelimit authtoken keystonecontext api
To see the rate limits, run: To see the rate limits, run:
.. code:: console .. code:: console
$ manila rate-limits $ manila rate-limits
+--------+------------+-------+--------+--------+----------------------+
| Verb | URI | Value | Remain | Unit | Next_Available |
+--------+------------+-------+--------+--------+----------------------+
| DELETE | "*" | 120 | 120 | MINUTE | 2015-10-20T15:17:20Z |
| POST | "*/shares" | 120 | 120 | MINUTE | 2015-10-20T15:17:20Z |
| PUT | "*/shares" | 120 | 120 | MINUTE | 2015-10-20T15:17:20Z |
+--------+------------+-------+--------+--------+----------------------+
Quotas Quotas
------ ------
@ -70,33 +84,33 @@ for the specified project.
.. code:: console .. code:: console
$ manila quota-show --tenant demo --user demo $ manila quota-show --tenant demo --user demo
+--------------------+-------+ +--------------------+-------+
| Property | Value | | Property | Value |
+--------------------+-------+ +--------------------+-------+
| gigabytes | 1000 | | gigabytes | 1000 |
| snapshot_gigabytes | 1000 | | snapshot_gigabytes | 1000 |
| snapshots | 50 | | snapshots | 50 |
| shares | 50 | | shares | 50 |
| share_networks | 10 | | share_networks | 10 |
+--------------------+-------+ +--------------------+-------+
There are default quotas for a project that are set from There are default quotas for a project that are set from
:file:`/etc/manila/manila.conf` file. To list default quotas for a project, use :file:`manila.conf` file. To list default quotas for a project, use
**manila quota-defaults** command: **manila quota-defaults** command:
.. code:: console .. code:: console
$ manila quota-defaults --tenant demo $ manila quota-defaults --tenant demo
+--------------------+-------+ +--------------------+-------+
| Property | Value | | Property | Value |
+--------------------+-------+ +--------------------+-------+
| gigabytes | 1000 | | gigabytes | 1000 |
| snapshot_gigabytes | 1000 | | snapshot_gigabytes | 1000 |
| snapshots | 50 | | snapshots | 50 |
| shares | 50 | | shares | 50 |
| share_networks | 10 | | share_networks | 10 |
+--------------------+-------+ +--------------------+-------+
Administrator can update the quotas for a specified tenant or for a specified Administrator can update the quotas for a specified tenant or for a specified
user by providing both ``--tenant`` and ``--user`` optional arguments. user by providing both ``--tenant`` and ``--user`` optional arguments.
@ -105,7 +119,7 @@ and ``share-networks`` quotas.
.. code:: console .. code:: console
$ manila quota-update demo --user demo --shares 49 --snapshots 49 $ manila quota-update demo --user demo --shares 49 --snapshots 49
As administrator, you can also permit or deny the force-update of a quota that As administrator, you can also permit or deny the force-update of a quota that
is already used and the requested value exceeds the configured quota. To is already used and the requested value exceeds the configured quota. To
@ -113,28 +127,10 @@ force-update a quota, use ``force`` optional key.
.. code:: console .. code:: console
$ manila quota-update demo --shares 51 --snapshots 51 --force $ manila quota-update demo --shares 51 --snapshots 51 --force
To revert quotas to default for a project or for a user, delete quotas: To revert quotas to default for a project or for a user, delete quotas:
.. code:: console .. code:: console
$ manila quota-delete --tenant demo --user demo $ manila quota-delete --tenant demo --user demo
It is possible to set quotas for a quota class and then check that the quotas
were updated:
.. code:: console
$ manila quota-class-update my_custom_class --shares 49 --snapshot_gigabytes 999
$ manila quota-class-show my_custom_class
+--------------------+-------+
| Property | Value |
+--------------------+-------+
| gigabytes | 1000 |
| snapshot_gigabytes | 999 |
| snapshots | 50 |
| shares | 49 |
| share_networks | 10 |
+--------------------+-------+

29
doc/admin-guide-cloud/source/shared_file_systems_scheduling.rst
View File

@ -4,29 +4,30 @@
Scheduling Scheduling
========== ==========
Shared File Systems service provides unified access for variety of different The Shared File Systems service provides unified access for variety of
types of shared file systems. To achieve this, Shared File Systems service different types of shared file systems. To achieve this, the Shared File
use scheduler. Scheduler collects information from active share services and Systems service uses a scheduler. The scheduler collects information from
take decisions, what share service will be used to create new share. To manage active share services and takes decisions, what share service will be used to
this process Shared File Systems service provides Share types API. create a new share. To manage this process, the Shared File Systems service
provides Share types API.
Share type is a list from key-value pairs called extra-specs. Some of them, A share type is a list from key-value pairs called extra-specs. Some of them,
called required and un-scoped extra-specs, scheduler uses for lookup the called required and un-scoped extra-specs, scheduler uses for lookup the
share service suitable for new share with specified share type. For more share service suitable for new share with specified share type. For more
information about extra-specs and their type see `Capabilities and Extra-Specs information about extra-specs and their type, see `Capabilities and Extra-Specs
<http://docs.openstack.org/developer/manila/devref/capabilities_and_extra_spec <http://docs.openstack.org/developer/manila/devref/capabilities_and_extra_spec
s.html>`_ section in developer documentation. s.html>`_ section in developer documentation.
In general scheduler workflow looks like: The general scheduler workflow in described below.
1) Share services report information about number of existed pools, their #. Share services report information about number of existing pools, their
capacities and capabilities. capacities and capabilities.
2) When request on share creation comes in, scheduler picks a service and pool #. When request on share creation comes in, scheduler picks a service and pool
that fits the need best to serve the request, using share type filters and that fits the need best to serve the request, using share type filters and
back end capabilities. If back end capabilities passes thought all filters back end capabilities. If back end capabilities passes thought all filters
request to the selected back end where the target pool resides; request to the selected back end where the target pool resides.
3) Share driver gets the message and lets the target pool serve the request #. Share driver gets the message and lets the target pool serve the request
as scheduler instructed. Share type extra-specs (scoped and un-scoped) as scheduler instructed. The scoped and un-scoped share type extra-specs
are available for the driver implementation to use as-needed. are available for the driver implementation to use as needed.

182
doc/admin-guide-cloud/source/shared_file_systems_security_services.rst
View File

@ -41,60 +41,60 @@ Create a ``ldap`` security service:
.. code:: console .. code:: console
$ manila security-service-create ldap --dns-ip 8.8.8.8 --server 10.254.0.3 --name my_ldap_security_service $ manila security-service-create ldap --dns-ip 8.8.8.8 --server 10.254.0.3 --name my_ldap_security_service
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| Property | Value | | Property | Value |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| status | new | | status | new |
| domain | None | | domain | None |
| password | None | | password | None |
| name | my_ldap_security_service | | name | my_ldap_security_service |
| dns_ip | 8.8.8.8 | | dns_ip | 8.8.8.8 |
| created_at | 2015-09-25T10:19:06.019527 | | created_at | 2015-09-25T10:19:06.019527 |
| updated_at | None | | updated_at | None |
| server | 10.254.0.3 | | server | 10.254.0.3 |
| user | None | | user | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| type | ldap | | type | ldap |
| id | 413479b2-0d20-4c58-a9d3-b129fa592d8e | | id | 413479b2-0d20-4c58-a9d3-b129fa592d8e |
| description | None | | description | None |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
To create ``kerberos`` security service, run: To create ``kerberos`` security service, run:
.. code:: console .. code:: console
$ manila security-service-create kerberos --server 10.254.0.3 --user demo --password secret --name my_kerberos_security_service --description "Kerberos security service" $ manila security-service-create kerberos --server 10.254.0.3 --user demo --password secret --name my_kerberos_security_service --description "Kerberos security service"
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| Property | Value | | Property | Value |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| status | new | | status | new |
| domain | None | | domain | None |
| password | secret | | password | secret |
| name | my_kerberos_security_service | | name | my_kerberos_security_service |
| dns_ip | None | | dns_ip | None |
| created_at | 2015-09-25T10:26:03.211849 | | created_at | 2015-09-25T10:26:03.211849 |
| updated_at | None | | updated_at | None |
| server | 10.254.0.3 | | server | 10.254.0.3 |
| user | demo | | user | demo |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| type | kerberos | | type | kerberos |
| id | 7f46a447-2534-453d-924d-bd7c8e63bbec | | id | 7f46a447-2534-453d-924d-bd7c8e63bbec |
| description | Kerberos security service | | description | Kerberos security service |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
To see the list of created security service use To see the list of created security service use
**manila security-service-list**: **manila security-service-list**:
.. code:: console .. code:: console
$ manila security-service-list $ manila security-service-list
+--------------------------------------+------------------------------+--------+----------+ +--------------------------------------+------------------------------+--------+----------+
| id | name | status | type | | id | name | status | type |
+--------------------------------------+------------------------------+--------+----------+ +--------------------------------------+------------------------------+--------+----------+
| 413479b2-0d20-4c58-a9d3-b129fa592d8e | my_ldap_security_service | new | ldap | | 413479b2-0d20-4c58-a9d3-b129fa592d8e | my_ldap_security_service | new | ldap |
| 7f46a447-2534-453d-924d-bd7c8e63bbec | my_kerberos_security_service | new | kerberos | | 7f46a447-2534-453d-924d-bd7c8e63bbec | my_kerberos_security_service | new | kerberos |
+--------------------------------------+------------------------------+--------+----------+ +--------------------------------------+------------------------------+--------+----------+
You can add a security service to the existing You can add a security service to the existing
:ref:`share network <shared_file_systems_share_networks>` that is not used yet :ref:`share network <shared_file_systems_share_networks>` that is not used yet
@ -107,68 +107,68 @@ new attribute ``share_networks`` with associated share network ID.
.. code:: console .. code:: console
$ manila share-network-security-service-add share_net2 my_ldap_security_service $ manila share-network-security-service-add share_net2 my_ldap_security_service
$ manila security-service-show my_ldap_security_service $ manila security-service-show my_ldap_security_service
+----------------+-------------------------------------------+ +----------------+-------------------------------------------+
| Property | Value | | Property | Value |
+----------------+-------------------------------------------+ +----------------+-------------------------------------------+
| status | new | | status | new |
| domain | None | | domain | None |
| password | None | | password | None |
| name | my_ldap_security_service | | name | my_ldap_security_service |
| dns_ip | 8.8.8.8 | | dns_ip | 8.8.8.8 |
| created_at | 2015-09-25T10:19:06.000000 | | created_at | 2015-09-25T10:19:06.000000 |
| updated_at | None | | updated_at | None |
| server | 10.254.0.3 | | server | 10.254.0.3 |
| share_networks | [u'6d36c41f-d310-4aff-a0c2-ffd870e91cab'] | | share_networks | [u'6d36c41f-d310-4aff-a0c2-ffd870e91cab'] |
| user | None | | user | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| type | ldap | | type | ldap |
| id | 413479b2-0d20-4c58-a9d3-b129fa592d8e | | id | 413479b2-0d20-4c58-a9d3-b129fa592d8e |
| description | None | | description | None |
+----------------+-------------------------------------------+ +----------------+-------------------------------------------+
It is possible to see the list of security services associated with It is possible to see the list of security services associated with
given share network. List security services for ``share_net2`` share network: given share network. List security services for ``share_net2`` share network:
.. code:: console .. code:: console
$ manila share-network-security-service-list share_net2 $ manila share-network-security-service-list share_net2
+--------------------------------------+--------------------------+--------+------+ +--------------------------------------+--------------------------+--------+------+
| id | name | status | type | | id | name | status | type |
+--------------------------------------+--------------------------+--------+------+ +--------------------------------------+--------------------------+--------+------+
| 413479b2-0d20-4c58-a9d3-b129fa592d8e | my_ldap_security_service | new | ldap | | 413479b2-0d20-4c58-a9d3-b129fa592d8e | my_ldap_security_service | new | ldap |
+--------------------------------------+--------------------------+--------+------+ +--------------------------------------+--------------------------+--------+------+
You also can dissociate a security service from the share network You also can dissociate a security service from the share network
and see that a security service now has empty list of share networks: and see that a security service now has empty list of share networks:
.. code:: console .. code:: console
$ manila share-network-security-service-remove share_net2 my_ldap_security_service $ manila share-network-security-service-remove share_net2 my_ldap_security_service
$ manila security-service-show my_ldap_security_service $ manila security-service-show my_ldap_security_service
+----------------+--------------------------------------+ +----------------+--------------------------------------+
| Property | Value | | Property | Value |
+----------------+--------------------------------------+ +----------------+--------------------------------------+
| status | new | | status | new |
| domain | None | | domain | None |
| password | None | | password | None |
| name | my_ldap_security_service | | name | my_ldap_security_service |
| dns_ip | 8.8.8.8 | | dns_ip | 8.8.8.8 |
| created_at | 2015-09-25T10:19:06.000000 | | created_at | 2015-09-25T10:19:06.000000 |
| updated_at | None | | updated_at | None |
| server | 10.254.0.3 | | server | 10.254.0.3 |
| share_networks | [] | | share_networks | [] |
| user | None | | user | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| type | ldap | | type | ldap |
| id | 413479b2-0d20-4c58-a9d3-b129fa592d8e | | id | 413479b2-0d20-4c58-a9d3-b129fa592d8e |
| description | None | | description | None |
+----------------+--------------------------------------+ +----------------+--------------------------------------+
Shared File Systems Storage allows you to update a security service fields Shared File Systems service allows you to update a security service fields
using **manila security-service-update** command with optional arguments using **manila security-service-update** command with optional arguments
such as ``--dns-ip``, ``--server``, ``--domain``, ``--user``, ``--password``, such as ``--dns-ip``, ``--server``, ``--domain``, ``--user``, ``--password``,
``--name``, or ``--description``. ``--name``, or ``--description``.
@ -178,4 +178,4 @@ run:
.. code:: console .. code:: console
$ manila security-service-delete my_ldap_security_service $ manila security-service-delete my_ldap_security_service

14
doc/admin-guide-cloud/source/shared_file_systems_services_manage.rst
View File

@ -4,12 +4,12 @@
Manage shares services Manage shares services
====================== ======================
The Shared File Systems service provides API allows to Cloud Administrator The Shared File Systems service provides API that allows to manage running
manage running share services (`Share services API share services (`Share services API
<http://developer.openstack.org/api-ref-share-v2.html#share-services>`_). <http://developer.openstack.org/api-ref-share-v2.html#share-services>`_).
It hasn't exposed in CLI client yet. Using raw API calls, it is possible Using ``manila service-list`` command, it is possible to get a list of all
to get list of running services all kinds. To select only share services, kinds of running services. To select only share services, you can pick items
you can pick items only have field ``binary`` equals to ``manila-share``. that have field ``binary`` equals to ``manila-share``. Also, you can enable or
Aslo, you can enable and disable share services. Disabling means that share disable share services using raw API requests. Disabling means that share
service excludes from scheduler cycle and new shares will not be placed on service excludes from scheduler cycle and new shares will not be placed on
disabled back end, but shares from this service stay available. disabled back end, but shares from this service stay available.

15
doc/admin-guide-cloud/source/shared_file_systems_share_management.rst
View File

@ -4,12 +4,6 @@
Share management Share management
================ ================
The default configuration of the Shared File Systems service uses the OpenStack
Block Storage based back end. In that case, the Shared File Systems service
cares about everything (VMs, networking, keypairs, security groups) by itself.
It is not production solution, but can help you to understand how the Shared
File Systems service works.
A share is a remote, mountable file system. You can mount a share to and access A share is a remote, mountable file system. You can mount a share to and access
a share from several hosts by several users at a time. a share from several hosts by several users at a time.
@ -25,12 +19,9 @@ The shares are based on of the supported Shared File Systems protocols:
* *GLUSTERFS*. Gluster file system (GlusterFS). * *GLUSTERFS*. Gluster file system (GlusterFS).
* *HDFS*. Hadoop Distributed File System (HDFS). * *HDFS*. Hadoop Distributed File System (HDFS).
.. note:: The Shared File Systems service provides set of drivers that enable you to use
various network file storage devices, instead of the base implementation. That
The Shared File Systems service provides set of drivers that enable you to is the real purpose of the Shared File Systems service service in production.
use various network file storage devices, instead of the base
implementation. That is the real purpose of the Shared File Systems service
service in production.
.. toctree:: .. toctree::
shared_file_systems_crud_share.rst shared_file_systems_crud_share.rst

129
doc/admin-guide-cloud/source/shared_file_systems_share_networks.rst
View File

@ -4,9 +4,10 @@
Share networks Share networks
============== ==============
Share network is an entity that encapsulates interaction with Networking Share network is an entity that encapsulates interaction with the OpenStack
service. If selected driver runs in mode requiring such kind of interaction, Networking service. If the share driver that you selected runs in a mode
you need to specify share network when share creates. requiring Networking service interaction, specify the share network when
creating a share network.
How to create share network How to create share network
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -15,15 +16,15 @@ List networks in a tenant, run:
.. code:: console .. code:: console
$ neutron net-list $ neutron net-list
+--------------+---------+---------------------------------------+ +--------------+---------+---------------------------------------+
| id | name | subnets | | id | name | subnets |
+--------------+---------+---------------------------------------+ +--------------+---------+---------------------------------------+
| bee7411d-... | public | 884a6564-0f11-... 2001:db8::/64 | | bee7411d-... | public | 884a6564-0f11-... 2001:db8::/64 |
| | | e6da81fa-5d5f-... 172.24.4.0/24 | | | | e6da81fa-5d5f-... 172.24.4.0/24 |
| 5ed5a854-... | private | 74dcfb5a-b4d7-... 10.0.0.0/24 | | 5ed5a854-... | private | 74dcfb5a-b4d7-... 10.0.0.0/24 |
| | | cc297be2-5213-... fd7d:177d:a48b::/64 | | | | cc297be2-5213-... fd7d:177d:a48b::/64 |
+--------------+---------+---------------------------------------+ +--------------+---------+---------------------------------------+
A share network stores network information that share servers can use where A share network stores network information that share servers can use where
shares are hosted. You can associate a share with a single share network. shares are hosted. You can associate a share with a single share network.
@ -59,24 +60,24 @@ To create a share network with private network and subnetwork, run:
.. code:: console .. code:: console
$ manila share-network-create --neutron-net-id 5ed5a854-21dc-4ed3-870a-117b7064eb21 --neutron-subnet-id 74dcfb5a-b4d7-4855-86f5-a669729428dc --name my_share_net --description "My first share network" $ manila share-network-create --neutron-net-id 5ed5a854-21dc-4ed3-870a-117b7064eb21 --neutron-subnet-id 74dcfb5a-b4d7-4855-86f5-a669729428dc --name my_share_net --description "My first share network"
+-------------------+--------------------------------------+ +-------------------+--------------------------------------+
| Property | Value | | Property | Value |
+-------------------+--------------------------------------+ +-------------------+--------------------------------------+
| name | my_share_net | | name | my_share_net |
| segmentation_id | None | | segmentation_id | None |
| created_at | 2015-09-24T12:06:32.602174 | | created_at | 2015-09-24T12:06:32.602174 |
| neutron_subnet_id | 74dcfb5a-b4d7-4855-86f5-a669729428dc | | neutron_subnet_id | 74dcfb5a-b4d7-4855-86f5-a669729428dc |
| updated_at | None | | updated_at | None |
| network_type | None | | network_type | None |
| neutron_net_id | 5ed5a854-21dc-4ed3-870a-117b7064eb21 | | neutron_net_id | 5ed5a854-21dc-4ed3-870a-117b7064eb21 |
| ip_version | None | | ip_version | None |
| nova_net_id | None | | nova_net_id | None |
| cidr | None | | cidr | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| description | My first share network | | description | My first share network |
+-------------------+--------------------------------------+ +-------------------+--------------------------------------+
The ``segmentation_id``, ``cidr``, ``ip_version``, and ``network_type`` The ``segmentation_id``, ``cidr``, ``ip_version``, and ``network_type``
share network attributes are automatically set to the values determined by the share network attributes are automatically set to the values determined by the
@ -86,12 +87,12 @@ Check network list, run:
.. code:: console .. code:: console
$ manila share-network-list $ manila share-network-list
+--------------------------------------+--------------+ +--------------------------------------+--------------+
| id | name | | id | name |
+--------------------------------------+--------------+ +--------------------------------------+--------------+
| 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | my_share_net | | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | my_share_net |
+--------------------------------------+--------------+ +--------------------------------------+--------------+
If you configured the Generic driver with ``driver_handles_share_servers = If you configured the Generic driver with ``driver_handles_share_servers =
True`` (with the share servers) and had already some operations in the Shared True`` (with the share servers) and had already some operations in the Shared
@ -100,40 +101,40 @@ list of networks. This network was created by Generic driver for inner usage.
.. code:: console .. code:: console
$ neutron net-list $ neutron net-list
+--------------+------------------------+------------------------------------+ +--------------+------------------------+------------------------------------+
| id | name | subnets | | id | name | subnets |
+--------------+------------------------+------------------------------------+ +--------------+------------------------+------------------------------------+
| 3b5a629a-e...| manila_service_network | 4f366100-50... 10.254.0.0/28 | | 3b5a629a-e...| manila_service_network | 4f366100-50... 10.254.0.0/28 |
| bee7411d-d...| public | 884a6564-01... 2001:db8::/64 | | bee7411d-d...| public | 884a6564-01... 2001:db8::/64 |
| | | e6da81fa-55... 172.24.4.0/24 | | | | e6da81fa-55... 172.24.4.0/24 |
| 5ed5a854-2...| private | 74dcfb5a-bd... 10.0.0.0/24 | | 5ed5a854-2...| private | 74dcfb5a-bd... 10.0.0.0/24 |
| | | cc297be2-51... fd7d:177d:a48b::/64 | | | | cc297be2-51... fd7d:177d:a48b::/64 |
+--------------+------------------------+------------------------------------+ +--------------+------------------------+------------------------------------+
You also can see detailed information about the share network including You also can see detailed information about the share network including
``network_type``, ``segmentation_id`` fields: ``network_type``, ``segmentation_id`` fields:
.. code:: console .. code:: console
$ neutron net-show manila_service_network $ neutron net-show manila_service_network
+---------------------------+--------------------------------------+ +---------------------------+--------------------------------------+
| Field | Value | | Field | Value |
+---------------------------+--------------------------------------+ +---------------------------+--------------------------------------+
| admin_state_up | True | | admin_state_up | True |
| id | 3b5a629a-e7a1-46a3-afb2-ab666fb884bc | | id | 3b5a629a-e7a1-46a3-afb2-ab666fb884bc |
| mtu | 0 | | mtu | 0 |
| name | manila_service_network | | name | manila_service_network |
| port_security_enabled | True | | port_security_enabled | True |
| provider:network_type | vxlan | | provider:network_type | vxlan |
| provider:physical_network | | | provider:physical_network | |
| provider:segmentation_id | 1068 | | provider:segmentation_id | 1068 |
| router:external | False | | router:external | False |
| shared | False | | shared | False |
| status | ACTIVE | | status | ACTIVE |
| subnets | 4f366100-5108-4fa2-b5b1-989a121c1403 | | subnets | 4f366100-5108-4fa2-b5b1-989a121c1403 |
| tenant_id | 24c6491074e942309a908c674606f598 | | tenant_id | 24c6491074e942309a908c674606f598 |
+---------------------------+--------------------------------------+ +---------------------------+--------------------------------------+
You also can add and remove the security services to the share network. For You also can add and remove the security services to the share network. For
details, see :ref:`shared_file_systems_security_services`. details, see :ref:`shared_file_systems_security_services`.

117
doc/admin-guide-cloud/source/shared_file_systems_share_resize.rst
View File

@ -5,8 +5,9 @@ Resize share
============ ============
To change file share size, use :command:`manila extend` and To change file share size, use :command:`manila extend` and
:command:`manila shrink`. For most drivers it is safe operation. In case of :command:`manila shrink`. For most drivers it is safe operation. If you want to
using generic driver it is better to create share snapshot for backup. be sure that your data is safe, you can make a share back up by creating a
snapshot of it.
You can extend and shrink the share with **manila extend** and You can extend and shrink the share with **manila extend** and
**manila shrink** commands correspondingly and specifying the share and new **manila shrink** commands correspondingly and specifying the share and new
@ -21,34 +22,34 @@ To extend the share and check the result, run:
.. code:: console .. code:: console
$ manila extend Share1 2 $ manila extend Share1 2
$ manila show Share1 $ manila show Share1
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| status | available | | status | available |
| share_type_name | default | | share_type_name | default |
| description | My first share. Updated | | description | My first share. Updated |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84-...| | export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84-...|
| share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 | | share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| size | 2 | | size | 2 |
| name | Share1 | | name | Share1 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-24T12:19:06.000000 | | created_at | 2015-09-24T12:19:06.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'deadline': u'01/30/16'} | | metadata | {u'deadline': u'01/30/16'} |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
While shrinking the share gets ``shrinking`` status that means that the While shrinking the share gets ``shrinking`` status that means that the
decrease share size request was issued successfully. To shrink the share and decrease share size request was issued successfully. To shrink the share and
@ -56,31 +57,31 @@ check the result, run:
.. code:: console .. code:: console
$ manila shrink Share1 1 $ manila shrink Share1 1
$ manila show Share1 $ manila show Share1
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| status | available | | status | available |
| share_type_name | default | | share_type_name | default |
| description | My first share. Updated | | description | My first share. Updated |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84-...| | export_locations | 10.254.0.3:/shares/share-2d5e2c0a-1f84-...|
| share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 | | share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | None | | snapshot_id | None |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| size | 1 | | size | 1 |
| name | Share1 | | name | Share1 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-24T12:19:06.000000 | | created_at | 2015-09-24T12:19:06.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'deadline': u'01/30/16'} | | metadata | {u'deadline': u'01/30/16'} |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+

92
doc/admin-guide-cloud/source/shared_file_systems_share_types.rst
View File

@ -5,20 +5,20 @@ Share types
=========== ===========
A share type enables you to filter or choose back ends before you create a A share type enables you to filter or choose back ends before you create a
share. A share type behaves in the same way as a Block Storage volume type share and to set data for the share driver. A share type behaves in the same
behaves. way as a Block Storage volume type behaves.
In the manila configuration file :file:`/etc/manila/manila.conf` administrator In the Shared File Systems configuration file :file:`manila.conf`, the
can set the share type used by default for the share creation and then create administrator can set the share type used by default for the share creation and
a default share type. then create a default share type.
To create a share type, use **manila type-create** command as: To create a share type, use **manila type-create** command as:
.. code:: console .. code:: console
manila type-create [--snapshot_support <snapshot_support>] manila type-create [--snapshot_support <snapshot_support>]
[--is_public <is_public>] [--is_public <is_public>]
<name> <spec_driver_handles_share_servers> <name> <spec_driver_handles_share_servers>
where the ``name`` is the share type name, ``--is_public`` defines the level of where the ``name`` is the share type name, ``--is_public`` defines the level of
the visibility for the share type, ``snapshot_support`` and the visibility for the share type, ``snapshot_support`` and
@ -43,8 +43,8 @@ used for the back ends filtering:
.. note:: .. note::
The extra specifications set in the share types are operated in the The extra specifications set in the share types are operated in the
:ref:`shared_file_systems_scheduling`. :ref:`shared_file_systems_scheduling`.
Administrators can also set additional extra specifications for a share type Administrators can also set additional extra specifications for a share type
for the following purposes: for the following purposes:
@ -83,14 +83,14 @@ can be public.
.. code:: console .. code:: console
$ manila type-create netapp1 False --is_public True $ manila type-create netapp1 False --is_public True
$ manila type-list $ manila type-list
+-----+--------+-----------+-----------+-----------------------------------+-----------------------+ +-----+--------+-----------+-----------+-----------------------------------+-----------------------+
| ID | Name | Visibility| is_default| required_extra_specs | optional_extra_specs | | ID | Name | Visibility| is_default| required_extra_specs | optional_extra_specs |
+-----+--------+-----------+-----------+-----------------------------------+-----------------------+ +-----+--------+-----------+-----------+-----------------------------------+-----------------------+
| c0..| netapp1| public | No | driver_handles_share_servers:False| snapshot_support:True | | c0..| netapp1| public | No | driver_handles_share_servers:False| snapshot_support:True |
+-----+--------+-----------+-----------+-----------------------------------+-----------------------+ +-----+--------+-----------+-----------+-----------------------------------+-----------------------+
You can set or unset extra specifications for a share type You can set or unset extra specifications for a share type
using **manila type-key <share_type> set <key=value>** command. Since it is up using **manila type-key <share_type> set <key=value>** command. Since it is up
@ -99,21 +99,21 @@ for a specified driver.
.. code:: console .. code:: console
$ manila type-key netapp1 set thin_provisioned=True $ manila type-key netapp1 set thin_provisioned=True
It is also possible for administrator to see a list of current share types and It is also possible for administrator to see a list of current share types and
extra specifications: extra specifications:
.. code:: console .. code:: console
$ manila extra-specs-list $ manila extra-specs-list
+-------------+---------+-------------------------------------+ +-------------+---------+-------------------------------------+
| ID | Name | all_extra_specs | | ID | Name | all_extra_specs |
+-------------+---------+-------------------------------------+ +-------------+---------+-------------------------------------+
| c0086582-...| netapp1 | snapshot_support : True | | c0086582-...| netapp1 | snapshot_support : True |
| | | thin_provisioned : True | | | | thin_provisioned : True |
| | | driver_handles_share_servers : True | | | | driver_handles_share_servers : True |
+-------------+---------+-------------------------------------+ +-------------+---------+-------------------------------------+
Use **manila type-key <share_type> unset <key>** to unset an extra Use **manila type-key <share_type> unset <key>** to unset an extra
specification. specification.
@ -126,45 +126,45 @@ The public or private share type can be deleted by means of
Share type access Share type access
----------------- -----------------
You can manage the access to the private for the different projects: add You can manage the access to the private share type for the different projects:
access, remove access, and get information about access for a specified add access, remove access, and get information about access for a specified
private share type. private share type.
Create a private type: Create a private type:
.. code:: console .. code:: console
$ manila type-create my_type1 True --is_public False $ manila type-create my_type1 True --is_public False
+-----+---------+-----------+-----------+----------------------------------+----------------------+ +-----+---------+-----------+-----------+----------------------------------+----------------------+
| ID | Name | Visibility| is_default| required_extra_specs | optional_extra_specs | | ID | Name | Visibility| is_default| required_extra_specs | optional_extra_specs |
+-----+---------+-----------+-----------+----------------------------------+----------------------+ +-----+---------+-----------+-----------+----------------------------------+----------------------+
| a4..| my_type1| private | - | driver_handles_share_servers:True| snapshot_support:True| | a4..| my_type1| private | - | driver_handles_share_servers:True| snapshot_support:True|
+-----+---------+-----------+-----------+----------------------------------+----------------------+ +-----+---------+-----------+-----------+----------------------------------+----------------------+
.. note:: .. note::
If you run **manila type-list** you see only public types. To see the If you run **manila type-list** you see only public types. To see the
private types also, run **manila type-list** with ``-all`` optional private types also, run **manila type-list** with ``-all`` optional
argument. argument.
Grant access to created private type for a demo and alt_demo projects Grant access to created private type for a demo and alt_demo projects
by providing their IDs: by providing their IDs:
.. code:: console .. code:: console
$ manila type-access-add my_type1 d8f9af6915404114ae4f30668a4f5ba7 $ manila type-access-add my_type1 d8f9af6915404114ae4f30668a4f5ba7
$ manila type-access-add my_type1 e4970f57f1824faab2701db61ee7efdf $ manila type-access-add my_type1 e4970f57f1824faab2701db61ee7efdf
Get information about access for a private share type ``my_type1``: Get information about access for a private share type ``my_type1``:
.. code:: console .. code:: console
$ manila type-access-list my_type1 $ manila type-access-list my_type1
+----------------------------------+ +----------------------------------+
| Project_ID | | Project_ID |
+----------------------------------+ +----------------------------------+
| d8f9af6915404114ae4f30668a4f5ba7 | | d8f9af6915404114ae4f30668a4f5ba7 |
| e4970f57f1824faab2701db61ee7efdf | | e4970f57f1824faab2701db61ee7efdf |
+----------------------------------+ +----------------------------------+
After you granted the access to the share type users that belong to project After you granted the access to the share type users that belong to project
with granted access can see the type in the list and create shares with with granted access can see the type in the list and create shares with

176
doc/admin-guide-cloud/source/shared_file_systems_snapshots.rst
View File

@ -4,61 +4,61 @@
Share snapshots Share snapshots
=============== ===============
The Shared File Systems service provides mechanism of snapshots to help users The Shared File Systems service provides a snapshot mechanism to help users
to restore theirs own data. Use :command:`manila snapshot-create` for it. restore data by running the `manila snapshot-create` command.
To export a snapshot, you can create shares from it, then mount new share to To export a snapshot, you can create shares from it, then mount new share to
instance and then directly copy files from attached share into archive. instance and then directly copy files from attached share into archive.
To import snapshot, create a new share with appropriate size, attach it to To import a snapshot, create a new share with appropriate size, attach it to
instance and then copy file from archive to attached file system. instance and then copy file from archive to attached file system.
.. note:: .. note::
You cannot delete a share while it has saved dependent snapshots. You cannot delete a share while it has saved dependent snapshots.
Create a snapshot from the share: Create a snapshot from the share:
.. code:: console .. code:: console
$ manila snapshot-create Share1 --name Snapshot1 --description "Snapshot of Share1" $ manila snapshot-create Share1 --name Snapshot1 --description "Snapshot of Share1"
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| Property | Value | | Property | Value |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| status | creating | | status | creating |
| share_id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | share_id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| name | Snapshot1 | | name | Snapshot1 |
| created_at | 2015-09-25T05:27:38.862040 | | created_at | 2015-09-25T05:27:38.862040 |
| share_proto | NFS | | share_proto | NFS |
| id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd | | id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd |
| size | 1 | | size | 1 |
| share_size | 1 | | share_size | 1 |
| description | Snapshot of Share1 | | description | Snapshot of Share1 |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
Update name or description of a snapshot if it is needed: Update name or description of a snapshot if it is needed:
.. code:: console .. code:: console
$ manila snapshot-rename Snapshot1 Snapshot_1 --description "Snapshot of Share1. Updated." $ manila snapshot-rename Snapshot1 Snapshot_1 --description "Snapshot of Share1. Updated."
Check that status of a snapshot is ``available``: Check that status of a snapshot is ``available``:
.. code:: console .. code:: console
$ manila snapshot-show Snapshot1 $ manila snapshot-show Snapshot1
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| Property | Value | | Property | Value |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
| status | available | | status | available |
| share_id | aca648eb-8c03-4394-a5cc-755066b7eb66 | | share_id | aca648eb-8c03-4394-a5cc-755066b7eb66 |
| name | Snapshot1 | | name | Snapshot1 |
| created_at | 2015-09-25T05:27:38.000000 | | created_at | 2015-09-25T05:27:38.000000 |
| share_proto | NFS | | share_proto | NFS |
| id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd | | id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd |
| size | 1 | | size | 1 |
| share_size | 1 | | share_size | 1 |
| description | Snapshot of Share1 | | description | Snapshot of Share1 |
+-------------+--------------------------------------+ +-------------+--------------------------------------+
To restore your data from snapshot, use :command:`manila create` with key To restore your data from snapshot, use :command:`manila create` with key
``--snapshot-id``. This creates a new share from exiting snapshot. ``--snapshot-id``. This creates a new share from exiting snapshot.
@ -66,62 +66,62 @@ Create a share from a snapshot and check whether it is available:
.. code:: console .. code:: console
$ manila create nfs 1 --name Share2 --metadata source=snapshot --description "Share from a snapshot." --snapshot-id 962e8126-35c3-47bb-8c00-f0ee37f42ddd $ manila create nfs 1 --name Share2 --metadata source=snapshot --description "Share from a snapshot." --snapshot-id 962e8126-35c3-47bb-8c00-f0ee37f42ddd
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| status | None | | status | None |
| share_type_name | default | | share_type_name | default |
| description | Share from a snapshot. | | description | Share from a snapshot. |
| availability_zone | None | | availability_zone | None |
| share_network_id | None | | share_network_id | None |
| export_locations | [] | | export_locations | [] |
| share_server_id | None | | share_server_id | None |
| host | None | | host | None |
| snapshot_id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd | | snapshot_id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | b6b0617c-ea51-4450-848e-e7cff69238c7 | | id | b6b0617c-ea51-4450-848e-e7cff69238c7 |
| size | 1 | | size | 1 |
| name | Share2 | | name | Share2 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-25T06:25:50.240417 | | created_at | 2015-09-25T06:25:50.240417 |
| export_location | None | | export_location | None |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'source': u'snapshot'} | | metadata | {u'source': u'snapshot'} |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
$ manila show Share2 $ manila show Share2
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
| status | available | | status | available |
| share_type_name | default | | share_type_name | default |
| description | Share from a snapshot. | | description | Share from a snapshot. |
| availability_zone | nova | | availability_zone | nova |
| share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a | | share_network_id | 5c3cbabb-f4da-465f-bc7f-fadbe047b85a |
| export_locations | 10.254.0.3:/shares/share-1dc2a471-3d47-...| | export_locations | 10.254.0.3:/shares/share-1dc2a471-3d47-...|
| share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 | | share_server_id | 41b7829d-7f6b-4c96-aea5-d106c2959961 |
| host | manila@generic1#GENERIC1 | | host | manila@generic1#GENERIC1 |
| snapshot_id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd | | snapshot_id | 962e8126-35c3-47bb-8c00-f0ee37f42ddd |
| is_public | False | | is_public | False |
| task_state | None | | task_state | None |
| snapshot_support | True | | snapshot_support | True |
| id | b6b0617c-ea51-4450-848e-e7cff69238c7 | | id | b6b0617c-ea51-4450-848e-e7cff69238c7 |
| size | 1 | | size | 1 |
| name | Share2 | | name | Share2 |
| share_type | c0086582-30a6-4060-b096-a42ec9d66b86 | | share_type | c0086582-30a6-4060-b096-a42ec9d66b86 |
| created_at | 2015-09-25T06:25:50.000000 | | created_at | 2015-09-25T06:25:50.000000 |
| share_proto | NFS | | share_proto | NFS |
| consistency_group_id | None | | consistency_group_id | None |
| source_cgsnapshot_member_id | None | | source_cgsnapshot_member_id | None |
| project_id | 20787a7ba11946adad976463b57d8a2f | | project_id | 20787a7ba11946adad976463b57d8a2f |
| metadata | {u'source': u'snapshot'} | | metadata | {u'source': u'snapshot'} |
+-----------------------------+-------------------------------------------+ +-----------------------------+-------------------------------------------+
You can soft-delete a snapshot using **manila snapshot-delete You can soft-delete a snapshot using **manila snapshot-delete
<snapshot_name_or_ID>**. If a snapshot is in busy state and during deleting <snapshot_name_or_ID>**. If a snapshot is in busy state and during deleting

45
doc/admin-guide-cloud/source/shared_file_systems_troubleshoot.rst
View File

@ -4,21 +4,21 @@
Troubleshoot Shared File Systems service Troubleshoot Shared File Systems service
======================================== ========================================
Failures in share service during share creation Failures in Share File Systems service during a share creation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If new shares go into ``error`` state during creation, follow next steps: If new shares go into ``error`` state during creation, follow next steps:
1. Make sure, that share services are running into debug mode. If it is not #. Make sure, that share services are running in debug mode. If the debug mode
true, you will not get any tips from logs how to fix your issue. is not set, you will not get any tips from logs how to fix your issue.
2. Find what a share service holds specified share. Do to that, run command #. Find what share service holds a specified share. Do to that, run command
:command:`manila show <share_id_or_name>` and find share host in the :command:`manila show <share_id_or_name>` and find a share host in the
output. Host uniquely identifies share service holds broken share. output. Host uniquely identifies what share service holds the broken share.
3. Look thought logs of this share service. Usually, it can be found at #. Look thought logs of this share service. Usually, it can be found at
``/etc/var/log/manila-share.log``. This log should contain kind of ``/etc/var/log/manila-share.log``. This log should contain kind of
traceback with extra information to help you find origin of issues. traceback with extra information to help you to find the origin of issues.
No valid host was found No valid host was found
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
@ -34,30 +34,27 @@ To solve this issue look carefully through list of extra specs in share type
and list of share service reported capabilities and make sure that extra specs and list of share service reported capabilities and make sure that extra specs
are pointed in the right way. are pointed in the right way.
Created share is unreachable Created share is unreachable
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
By default new share doesn't have any active access rules. So, to provide By default, a new share does not have any active access rules. To provide
access to new created share, you need to create appropriate access rule with access to new created share, you need to create appropriate access rule with
right value that defines access. right value that defines access.
Service become unavailable after upgrade Service becomes unavailable after upgrade
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
After upgrading Shared File Systems service from version v1 to version v2.x,
please be attentive to update service endpoint in OpenStack Identity Service.
Use :command:`keystone service-list` to get service type related to Shared
File Systems service and then :command:`keystone service-list --service
<share-service-type>`. You will get endpoints expected from running
Shared File Systems service. Make sure that these endpoints are update.
If it is not true, you need delete outdated endpoints and create a new one.
After upgrading the Shared File Systems service from version v1 to version
v2.x, please be attentive to update service endpoint in OpenStack Identity
Service. Use :command:`keystone service-list` to get service type related to
Shared File Systems service and then :command:`keystone service-list --service
<share-service-type>` command. You will get endpoints expected from running
Shared File Systems service. Make sure that these endpoints are updated.
If it is not true, you need to delete outdated endpoints and create new ones.
Failures during management of internal resources Failures during management of internal resources
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Some drivers in Shared File Systems service can create service entities, like Some drivers in Shared File Systems service can create service entities, like
servers and networks. If it is necessary to reach it you can login in servers and networks. If it is necessary to reach it you can log in to tenant
tenant ``service`` and get manual control over it. ``service`` and get manual control over it.