manila-data

This repository contains the source for the OpenStack Manila Data snap.

The manila-data daemon is part of OpenStack Manila (https://docs.openstack.org/manila/latest/), the Shared Filesystems service. It handles data-intensive operations such as:

• Share migration — both driver-assisted and host-assisted migration of data between share backends.
• Share creation from snapshots — copying data when creating a new share from an existing snapshot requires a data transfer.

The snap packages the upstream manila-data binary together with Ceph (ceph-common) and NFS support, manages its configuration files via Jinja2 templating, and runs the service as a strictly-confined snap daemon.

This snap is designed to be used with a deployed OpenStack control plane such as delivered by Sunbeam (https://canonical-openstack.readthedocs-hosted.com/en/latest/how-to/features/shared-filesystem/).

Getting Started

Installation

Install the snap from the Snap Store:

sudo snap install manila-data

Required configuration

The service will not start until the database and message queue connections are provided:

sudo snap set manila-data \
    database.url=mysql+pymysql://manila:password@10.152.183.210/manila

sudo snap set manila-data \
    rabbitmq.url=rabbit://manila:supersecure@10.152.183.212:5672/openstack

Once both values are set the configure hook will render the configuration files and start (or restart) the manila-data daemon automatically.

Verifying the service

sudo snap services manila-data

Logs are written to syslog. You can also inspect the snap-specific log:

sudo snap logs manila-data

Configuration Reference

All options are set with snap set manila-data <key>=<value> and read with snap get manila-data <key>.

database

• database.url — Full SQLAlchemy connection URL to the Manila database (e.g. mysql+pymysql://user:pass@host/manila)

rabbitmq

• rabbitmq.url — Full connection URL to the RabbitMQ broker (e.g. rabbit://user:pass@host:5672/openstack)

settings

• settings.debug (default: false) — Enable debug-level logging
• settings.enable-telemetry-notifications (default: false) — Enable Oslo messaging notifications for telemetry (Ceilometer)

Snap Interfaces

The snap uses the following interfaces (https://snapcraft.io/docs/supported-interfaces):

• network — Outbound network access (database, RabbitMQ)
• network-bind — Listen for incoming connections
• mount-observe — Observe mount points on the host
• nfs-mount — Mount and unmount NFS shares