manila generic #13

Description

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
use-internal-endpoints
(boolean) Openstack mostly defaults to using public endpoints for internal communication between services. If set to True this option will configure services to use internal endpoints where possible.
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.