manila/install-guide/source/common/dhss-true-mode-configuration.rst
Goutham Pacha Ravi bc4712e35e Manila install guide: Fix wrong instructions
Previously only the DHSS=True mode was documented
in post install steps. The assumption that the generic driver
was being configured existed in other places as well.

* add DHSS=False documentation as necessary with the
   LVM driver.
* correct assumptions in other places to clarify usage
   of appropriate share driver modes.

Change-Id: Ic1356453e510e8f360269fb45a41379329ce68c2
Closes-Bug: #1616257
2016-09-16 17:35:43 +00:00

2.9 KiB

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

      [DEFAULT]
      ...
      enabled_share_backends = generic
      enabled_share_protocols = NFS

      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.

      Important

      The service_image_name, service_instance_flavor_id, service_instance_user and service_instance_password are with reference to the service image that is used by the driver to create share servers. A sample service image for use with the generic driver is available in the manila-image-elements project. Its creation is explained in the post installation steps (See: post-install).