openstack/openstack-manuals
Code Issues Proposed changes
dda17bed46
openstack-manuals/doc/install-guide/source/manila-share-install-dhss-true-option2.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

3.9 KiB
Raw Blame History

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:

    obs

    # zypper install --no-recommends openstack-neutron-linuxbridge-agent

    rdo

    # yum install openstack-neutron openstack-neutron-linuxbridge ebtables

    ubuntu

    # apt-get install neutron-plugin-linuxbridge-agent

Configure components

  1. 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:

      [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:

      [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:

      [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 Finalize installation <manila-share-finalize-install>.