a8af40d1d9
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
133 lines
3.9 KiB
ReStructuredText
133 lines
3.9 KiB
ReStructuredText
Shared File Systems Option 2: Driver support for share servers management
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
For simplicity, this configuration references the same storage node
|
|
configuration for the Block Storage service.
|
|
|
|
.. note::
|
|
|
|
This guide describes how to configure the Shared File Systems service to
|
|
use the ``generic`` driver with the driver handles share server mode
|
|
(DHSS) enabled. This mode requires Compute (nova), Networking (neutron) and
|
|
Block storage (cinder) services for managing share servers. The information
|
|
used for creating share servers is configured as share networks. Generic
|
|
driver with DHSS enabled also requires network to be attached to a public
|
|
router.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
Before you proceed, verify operation of the Compute, Networking, and Block
|
|
Storage services. This options requires implementation of Networking option 2
|
|
and requires installation of some Networking service components on the storage
|
|
node.
|
|
|
|
* Install the Networking service components:
|
|
|
|
.. only:: obs
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper install --no-recommends openstack-neutron-linuxbridge-agent
|
|
|
|
.. only:: rdo
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install openstack-neutron openstack-neutron-linuxbridge ebtables
|
|
|
|
.. only:: ubuntu
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get install neutron-plugin-linuxbridge-agent
|
|
|
|
Configure components
|
|
--------------------
|
|
|
|
.. include:: shared/note_configuration_vary_by_distribution.rst
|
|
|
|
#. Edit the ``/etc/manila/manila.conf`` file and complete the following
|
|
actions:
|
|
|
|
* In the ``[DEFAULT]`` section, enable the generic driver and the NFS/CIFS
|
|
protocols:
|
|
|
|
.. code-block:: ini
|
|
|
|
[DEFAULT]
|
|
...
|
|
enabled_share_backends = generic
|
|
enabled_share_protocols = NFS,CIFS
|
|
|
|
.. note::
|
|
|
|
Back end names are arbitrary. As an example, this guide uses the name
|
|
of the driver.
|
|
|
|
* In the ``[neutron]``, ``[nova]``, and ``[cinder]`` sections, enable
|
|
authentication for those services:
|
|
|
|
.. code-block:: ini
|
|
|
|
[neutron]
|
|
...
|
|
url = http://controller:9696
|
|
auth_uri = http://controller:5000
|
|
auth_url = http://controller:35357
|
|
memcached_servers = controller:11211
|
|
auth_type = password
|
|
project_domain_name = default
|
|
user_domain_name = default
|
|
region_name = RegionOne
|
|
project_name = service
|
|
username = neutron
|
|
password = NEUTRON_PASS
|
|
|
|
[nova]
|
|
...
|
|
auth_uri = http://controller:5000
|
|
auth_url = http://controller:35357
|
|
memcached_servers = controller:11211
|
|
auth_type = password
|
|
project_domain_name = default
|
|
user_domain_name = default
|
|
region_name = RegionOne
|
|
project_name = service
|
|
username = nova
|
|
password = NOVA_PASS
|
|
|
|
[cinder]
|
|
...
|
|
auth_uri = http://controller:5000
|
|
auth_url = http://controller:35357
|
|
memcached_servers = controller:11211
|
|
auth_type = password
|
|
project_domain_name = default
|
|
user_domain_name = default
|
|
region_name = RegionOne
|
|
project_name = service
|
|
username = cinder
|
|
password = CINDER_PASS
|
|
|
|
* In the ``[generic]`` section, configure the generic driver:
|
|
|
|
.. code-block:: ini
|
|
|
|
[generic]
|
|
share_backend_name = GENERIC
|
|
share_driver = manila.share.drivers.generic.GenericShareDriver
|
|
driver_handles_share_servers = True
|
|
service_instance_flavor_id = 100
|
|
service_image_name = manila-service-image
|
|
service_instance_user = manila
|
|
service_instance_password = manila
|
|
interface_driver = manila.network.linux.interface.BridgeInterfaceDriver
|
|
|
|
.. note::
|
|
|
|
You can also use SSH keys instead of password authentication for
|
|
service instance credentials.
|
|
|
|
Return to :ref:`Finalize installation <manila-share-finalize-install>`.
|