openstack-manuals/doc/install-guide/source/launch-instance-manila.rst
dencaval a8af40d1d9 [install] Add steps for manila without the share server management mode
Performs refactoring for better documenting both manila modes:
with/without the management of share servers.

Closes-Bug: #1559031
Implements: bp installguide-mitaka

Change-Id: Id21bce7fb5ea450a3150cb194184c2cb553320b5
2016-04-11 08:24:00 -06:00

107 lines
4.6 KiB
ReStructuredText

.. _launch-instance-manila:
Shared File Systems
~~~~~~~~~~~~~~~~~~~
Create the service image
------------------------
.. note::
In typical deployments, you should create an instance from an image that
supports network file systems such as NFS/CIFS to evaluate the Shared File
Systems service. This guide should use the CirrOS image for instances to
reduce resource requirements for evaluation. However, the CirrOS image
lacks support for network file systems. For evaluation of the Shared File
Systems service, this guide creates a regular instance using the
``manila-share-service`` image because it supports network file systems and
using the ``manila-service-flavor`` that limits resource consumption by the
instance to 256 MB memory on the compute node.
#. Download the source image of the share server:
.. code-block:: console
$ wget http://tarballs.openstack.org/manila-image-elements/images/manila-service-image-master.qcow2
#. Add the image to the Image service:
.. code-block:: console
# openstack image create "manila-service-image" \
--file manila-service-image-master.qcow2 \
--disk-format qcow2 \
--container-format bare \
--public
+------------------+------------------------------------------------------+
| Field | Value |
+------------------+------------------------------------------------------+
| checksum | abb1fdf972162c7214db9fad43229dad |
| container_format | bare |
| created_at | 2016-03-16T23:37:51Z |
| disk_format | qcow2 |
| file | /v2/images/dcec8c7f-4c59-4223-a06f-220231b49c0c/file |
| id | dcec8c7f-4c59-4223-a06f-220231b49c0c |
| min_disk | 0 |
| min_ram | 0 |
| name | manila-service-image |
| owner | fd4a657caa054ca99d8b4179722f49de |
| protected | False |
| schema | /v2/schemas/image |
| size | 324665344 |
| status | active |
| tags | |
| updated_at | 2016-03-16T23:37:55Z |
| virtual_size | None |
| visibility | public |
+------------------+------------------------------------------------------+
#. Create a new flavor to support the service image:
.. code-block:: console
# openstack flavor create manila-service-flavor --id 100 --ram 256 --disk 0 --vcpus 1
+----------------------------+-----------------------+
| Field | Value |
+----------------------------+-----------------------+
| OS-FLV-DISABLED:disabled | False |
| OS-FLV-EXT-DATA:ephemeral | 0 |
| disk | 0 |
| id | 100 |
| name | manila-service-flavor |
| os-flavor-access:is_public | True |
| ram | 256 |
| rxtx_factor | 1.0 |
| swap | |
| vcpus | 1 |
+----------------------------+-----------------------+
.. note::
Flavor is image specific and may differ from image to image.
Launch an instance of the service image
---------------------------------------
.. note::
This section uses ``manila-service-image`` image as an instance for
mounting shares.
#. Launch an instance using the ``manila-service-image`` and
``manila-service-flavor``.
#. Log into the instance using ``manila`` as the username and password.
Create a share
--------------
Create a share for the Shared File Systems service option that you chose
in :ref:`manila-storage`.
.. toctree::
:maxdepth: 1
launch-instance-manila-dhss-false-option1.rst
launch-instance-manila-dhss-true-option2.rst