dfbe3ea418
The OpenStack install guide team has recommended that projects that are not part of the starter-kit:compute [1] (and a few other projects like Cinder and Horizon) maintain their install guide in-tree. [2] [1] http://governance.openstack.org/reference/tags/starter-kit_compute.html [2] http://git.openstack.org/cgit/openstack/docs-specs/tree/specs/newton/project-specific-installguides.rst Change-Id: I2b49fcfd99b3be40bb1ae7d7b8348abdb5b58b90 Co-Authored-By: Denis Cavalcante <dencaval@gmail.com> Implements: blueprint manila-in-tree-install-guide Partially-implements: blueprint projectspecificinstallguides
197 lines
10 KiB
ReStructuredText
197 lines
10 KiB
ReStructuredText
.. _post-install:
|
|
|
|
Creating shared file systems
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Before being able to create a share, manila with the generic driver and
|
|
the DHSS mode enabled requires the definition of at least an image,
|
|
a network and a share-network for being used to create a share server.
|
|
For that `back end` configuration, the share server is an instance where
|
|
NFS/CIFS shares are served.
|
|
|
|
.. note::
|
|
|
|
This configuration automatically creates a cinder volume for every share.
|
|
The cinder volumes are attached to share servers according to the
|
|
definition of a share network.
|
|
|
|
Determine the configuration of the share server
|
|
-----------------------------------------------
|
|
|
|
#. Source the admin credentials to gain access to admin-only CLI commands:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . admin-openrc.sh
|
|
|
|
#. Create a default share type before running manila-share service:
|
|
|
|
.. code-block:: console
|
|
|
|
$ manila type-create default_share_type True
|
|
+--------------------------------------+--------------------+------------+------------+-------------------------------------+-------------------------+
|
|
| ID | Name | Visibility | is_default | required_extra_specs | optional_extra_specs |
|
|
+--------------------------------------+--------------------+------------+------------+-------------------------------------+-------------------------+
|
|
| 8a35da28-0f74-490d-afff-23664ecd4f01 | default_share_type | public | - | driver_handles_share_servers : True | snapshot_support : True |
|
|
+--------------------------------------+--------------------+------------+------------+-------------------------------------+-------------------------+
|
|
|
|
#. Create a manila share server image to the Image service:
|
|
|
|
.. code-block:: console
|
|
|
|
$ glance image-create \
|
|
--copy-from http://tarballs.openstack.org/manila-image-elements/images/manila-service-image-master.qcow2 \
|
|
--name "manila-service-image" \
|
|
--disk-format qcow2 \
|
|
--container-format bare \
|
|
--visibility public --progress
|
|
[=============================>] 100%
|
|
+------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+------------------+--------------------------------------+
|
|
| checksum | 48a08e746cf0986e2bc32040a9183445 |
|
|
| container_format | bare |
|
|
| created_at | 2016-01-26T19:52:24Z |
|
|
| disk_format | qcow2 |
|
|
| id | 1fc7f29e-8fe6-44ef-9c3c-15217e83997c |
|
|
| min_disk | 0 |
|
|
| min_ram | 0 |
|
|
| name | manila-service-image |
|
|
| owner | e2c965830ecc4162a002bf16ddc91ab7 |
|
|
| protected | False |
|
|
| size | 306577408 |
|
|
| status | active |
|
|
| tags | [] |
|
|
| updated_at | 2016-01-26T19:52:28Z |
|
|
| virtual_size | None |
|
|
| visibility | public |
|
|
+------------------+--------------------------------------+
|
|
|
|
#. List available networks in order to get id and subnets of the private
|
|
network:
|
|
|
|
.. code-block:: console
|
|
|
|
$ neutron net-list
|
|
+--------------------------------------+---------+----------------------------------------------------+
|
|
| id | name | subnets |
|
|
+--------------------------------------+---------+----------------------------------------------------+
|
|
| 0e62efcd-8cee-46c7-b163-d8df05c3c5ad | public | 5cc70da8-4ee7-4565-be53-b9c011fca011 10.3.31.0/24 |
|
|
| 7c6f9b37-76b4-463e-98d8-27e5686ed083 | private | 3482f524-8bff-4871-80d4-5774c2730728 172.16.1.0/24 |
|
|
+--------------------------------------+---------+----------------------------------------------------+
|
|
|
|
#. Source the ``demo`` credentials to perform
|
|
the following steps as a non-administrative project:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . demo-openrc.sh
|
|
|
|
.. code-block:: console
|
|
|
|
$ manila share-network-create --name demo-share-network1 \
|
|
--neutron-net-id PRIVATE_NETWORK_ID \
|
|
--neutron-subnet-id PRIVATE_NETWORK_SUBNET_ID
|
|
+-------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+-------------------+--------------------------------------+
|
|
| name | demo-share-network1 |
|
|
| segmentation_id | None |
|
|
| created_at | 2016-01-26T20:03:41.877838 |
|
|
| neutron_subnet_id | 3482f524-8bff-4871-80d4-5774c2730728 |
|
|
| updated_at | None |
|
|
| network_type | None |
|
|
| neutron_net_id | 7c6f9b37-76b4-463e-98d8-27e5686ed083 |
|
|
| ip_version | None |
|
|
| nova_net_id | None |
|
|
| cidr | None |
|
|
| project_id | e2c965830ecc4162a002bf16ddc91ab7 |
|
|
| id | 58b2f0e6-5509-4830-af9c-97f525a31b14 |
|
|
| description | None |
|
|
+-------------------+--------------------------------------+
|
|
|
|
Create a share
|
|
--------------
|
|
|
|
#. Create a NFS share using the share network:
|
|
|
|
.. code-block:: console
|
|
|
|
$ manila create NFS 1 --name demo-share1 --share-network demo-share-network1
|
|
+-----------------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+-----------------------------+--------------------------------------+
|
|
| status | None |
|
|
| share_type_name | None |
|
|
| description | None |
|
|
| availability_zone | None |
|
|
| share_network_id | None |
|
|
| export_locations | [] |
|
|
| host | None |
|
|
| snapshot_id | None |
|
|
| is_public | False |
|
|
| task_state | None |
|
|
| snapshot_support | True |
|
|
| id | 016ca18f-bdd5-48e1-88c0-782e4c1aa28c |
|
|
| size | 1 |
|
|
| name | demo-share1 |
|
|
| share_type | None |
|
|
| created_at | 2016-01-26T20:08:50.502877 |
|
|
| export_location | None |
|
|
| share_proto | NFS |
|
|
| consistency_group_id | None |
|
|
| source_cgsnapshot_member_id | None |
|
|
| project_id | 48e8c35b2ac6495d86d4be61658975e7 |
|
|
| metadata | {} |
|
|
+-----------------------------+--------------------------------------+
|
|
|
|
#. After some time, the share status should change from ``creating``
|
|
to ``available``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ manila list
|
|
+--------------------------------------+-------------+------+-------------+-----------+-----------+--------------------------------------+---------------------------------------------------------------+-----------------------------+-------------------+
|
|
| ID | Name | Size | Share Proto | Status | Is Public | Share Type | Export location | Host | Availability Zone |
|
|
+--------------------------------------+-------------+------+-------------+-----------+-----------+--------------------------------------+---------------------------------------------------------------+-----------------------------+-------------------+
|
|
| 5f8a0574-a95e-40ff-b898-09fd8d6a1fac | demo-share1 | 1 | NFS | available | False | 8a35da28-0f74-490d-afff-23664ecd4f01 | 10.254.0.6:/shares/share-0bfd69a1-27f0-4ef5-af17-7cd50bce6550 | storagenode@generic#GENERIC | nova |
|
|
+--------------------------------------+-------------+------+-------------+-----------+-----------+--------------------------------------+---------------------------------------------------------------+-----------------------------+-------------------+
|
|
|
|
#. Configure user access to the new share before attempting to mount it via
|
|
the network:
|
|
|
|
.. important ::
|
|
|
|
The image used for launching an instance and mounting a share must have
|
|
the NFS packages provided by the distro. Example: The cirros image
|
|
created at the image service section is not enough.
|
|
|
|
.. important ::
|
|
|
|
Use an instance that is connected to the private network used to create
|
|
the share-network.
|
|
|
|
.. code-block:: console
|
|
|
|
$ manila access-allow demo-share1 ip INSTANCE_PRIVATE_NETWORK_IP
|
|
|
|
Mount the share from an instance
|
|
--------------------------------
|
|
|
|
#. Create a folder where the mount will be placed:
|
|
|
|
.. code-block:: console
|
|
|
|
$ mkdir ~/test_folder
|
|
|
|
#. Mount the NFS share in the instance using the export location of the share:
|
|
|
|
.. code-block:: console
|
|
|
|
$ mount -v 10.254.0.6:/shares/share-0bfd69a1-27f0-4ef5-af17-7cd50bce6550 ~/test_folder
|
|
|
|
|
|
For more information about how to manage shares, see the
|
|
`OpenStack User Guide
|
|
<http://docs.openstack.org/user-guide/index.html>`__.
|