The Manil share file system service provides a set of services for management
of shared file systems in a multi-tenant cloud environment. The service
resembles OpenStack block-based storage management from the OpenStack Block
Storage service project. With the Shared File Systems service, you can create
a remote file system, mount the file system on your instances, and then read
and write data from your instances to and from your file system.

The manila-generic plugin (using the manila-plugin relation) provides the
configuration information to the manila charm to configure the Manila
instance such that it can use the generic driver appropriately.

Overview

This is a pre-release charm intended for testing only.

This charm configures the generic backend in the related manila charm in an
OpenStack cloud. This provides NFS shares using Cinder as a backing store. It
should be used for testing and development purposes only.

Usage

The charm relies on the prinical manila charm, and is a subordinate to it. It
provides configuration data to the manila-share service (which is provided by
the manila charm with a role that includes 'share').

If multiple, different, generic backend configurations are required then the
share-backend-name config option should be used to differentiate between the
configuration sections.

Note: this subordinate charm requests that manila configure the nova, neutron
and cinder sections that the generic driver needs to launch NFS share instances
that provide NFS/CIFS services within their tenant networks. The manila charm
provides the main manila service username/password to this charm to enable it
to provide those configuration sections.

Bugs

Please report bugs on Launchpad.

For general questions please refer to the OpenStack Charm Guide.

Configuration

driver-service-instance-flavor-id
(int)
                            The ID for the flavor to launch images in. The driver blocks if this is
not set.

                        
driver-service-instance-user
(string)
                            The user to log into the share instance.
                        
manila
driver-keypair-name
(string)
                            This is the keypair name that will be provided to nova instances.  Note
that manila uploads the keypair from the config settings
'generic-driver-ssh-private-key' and 'generic-driver-ssh-public-key'.  If
neither the ssh config vars are set nor the password then the charm will
block until they are set.

                        
manila-service
verbose
(boolean)
                            Enable verbose logging
                        
driver-service-instance-password
(string)
                            If the service user doesn't log in with a key-pair a password is needed
to allow manila to ssh into the service instance.  If the password is set
then it is used and an SSH key is not configured.

                        
driver-service-image-name
(string)
                            the image name to use for the generic instance
                        
manila-service-image
share-backend-name
(string)
                            The name given to the backend.  This is used to generate the backend
configuration section and link it into the share server.  If two
different configurations of the same backend type are needed, then this
config option can be used to separate them in the backend configuration.

                        
generic
driver-handles-share-servers
(boolean)
                            Whether to generic driver should run up a share server.
                        
True
driver-service-ssh-key-public
(string)
                            The public key for the manila to inject into the instance.  If set,
manila will inject it into OpenStack if the keypair name doesn't exist.

                        
driver-service-ssh-key
(string)
                            The key for the manila to inject into the instance.  If set, manila will
inject it into OpenStack if the keypair name doesn't exist.

                        
openstack-origin
(string)
                            Repository from which to install.  May be one of the following:
distro (default), ppa:somecustom/ppa, a deb url sources entry,
or a supported Cloud Archive release pocket.

Supported Cloud Archive sources include: cloud:precise-folsom,
cloud:precise-folsom/updates, cloud:precise-folsom/staging,
cloud:precise-folsom/proposed.

Note that updating this setting to a source that is known to
provide a later version of OpenStack will trigger a software
upgrade.

                        
distro
share-protocols
(string)
                            The share protocols that the backends will be able to provide.  The
default is good for the generic backends.  Other backends may not support
both NFS and CIFS.  This is a space delimited list of protocols.

                        
NFS CIFS
debug
(boolean)
                            Enable debug logging
                        
driver-connect-share-server-to-tenant-network
(boolean)
                            Whether to connect the share server into the tenant network.
                        
True
driver-auth-type
(string)
                            One of 'password', 'ssh', 'both'.  This determines how manila
authenticates against the service-instance; e.g. using password, ssh
keypair or both.

                        
use-syslog
(boolean)
                            Setting this to True will allow supporting services to log to syslog.