openstack
/
charm-manila-ganesha
Code Issues Proposed changes
charm-manila-ganesha/src
History
Alex Kavanagh 00cfc7c91d 21.04 libraries freeze for charms on master branch 
* charm-helpers sync for classic charms
* build.lock file for reactive charms
* ensure tox.ini is from release-tools
* ensure requirements.txt files are from release-tools
* On reactive charms:
  - ensure stable/21.04 branch for charms.openstack
  - ensure stable/21.04 branch for charm-helpers

Change-Id: Iaef45249094f68204f8c34c53c6a13e948d6dc8c
 		2021-04-07 18:39:09 +00:00
..
files Release sync for 20.08 2020-08-11 19:42:13 +03:00
lib Fix HA setup/bundles and allow renaming 2020-11-22 20:52:00 -05:00
reactive Fix HA setup/bundles and allow renaming 2020-11-22 20:52:00 -05:00
templates Fix HA setup/bundles and allow renaming 2020-11-22 20:52:00 -05:00
tests Prune gate tests 2021-02-20 19:24:04 -07:00
README.md Fix HA setup/bundles and allow renaming 2020-11-22 20:52:00 -05:00
build.lock 21.04 libraries freeze for charms on master branch 2021-04-07 18:39:09 +00:00
config.yaml Add local tests to validate share config 2019-10-31 10:55:56 +01:00
icon.svg Remove inherited configuration options invalid for charm 2020-05-18 09:04:50 +02:00
layer.yaml Remove inherited configuration options invalid for charm 2020-05-18 09:04:50 +02:00
metadata.yaml Add hirsute and remove trusty from metadata.yaml 2021-03-02 20:58:19 +00:00
test-requirements.txt 21.04 libraries freeze for charms on master branch 2021-04-07 18:39:09 +00:00
tox.ini Sync release-tools 2020-12-15 11:26:47 +01:00
wheelhouse.txt 21.04 libraries freeze for charms on master branch 2021-04-07 18:39:09 +00:00

README.md

Manila Ganesha

This charm provides Ganesha with CephFS as a storage backend for Manila, OpenStack's shared filesystem service.

Usage

Manila (charm 'manila') and this 'manila-ganesha' charm rely on services provided by the following charms: 'percona-cluster' (MySQL), 'rabbitmq-server', and 'keystone'. A charmed CephFS solution is also needed for the backend: 'ceph-fs' ('ceph-mon' is typically already included with OpenStack). High availability is a separate topic.

Spaces

This charm can optionally dedicate a provider's physical network to serving Ganesha NFS shares. It does so through its support for Juju spaces. The charm uses a space called 'tenant-storage'.

Deployment

One way to deploy Manila Ganesha is to use a bundle overlay when deploying OpenStack via a bundle:

juju deploy ./base.yaml --overlay ./manila-ganesha-overlay.yaml

See appendix Manila Ganesha: Ceph-backed Shared Filesystem Service in the OpenStack Charms Deployment Guide to see what such an overlay may look like as well as for more general information on using Manila Ganesha with charmed OpenStack.

High Availability

This charm supports active/passive HA when deployed in a cluster with the hacluster charm. This is done by co-locating manila-share and nfs-ganesha systemd services on the same unit, and ensuring that those services are running only on the master unit with the VIP. Once an HA deployment is complete, pacemaker will ensure that only one unit is running the services.

If a second unit starts the services while the first is connected to CephFS, the first will be evicted and its session state corrupted.

Any restarts of manila-ganesha services that aren't controlled by the charm or pacemaker can result in evicted sessions.

Bugs

Please report bugs on Launchpad.

For general charm questions refer to the OpenStack Charm Guide.