Skip to content

Manila

This page is the starting point for Manila, the manila role: the containers manila_api, manila_scheduler, manila_share and manila_data, on the control and network nodes of the example inventory, selected by the tag manila. The manila-share hosts also get neutron agents (Component dependencies §3): the neutron play includes manila-share (fact sheet D §4.1). The lists below say where the study covers how to operate it, its impact, its dependencies and the evidence, what to check around a run and what stays open; the service card follows them.

Where to look

Operate

No operation page gives a command line for the manila tag, and the tag has no row of its own in Tags §3 or in the Tag index. What the study says about running it is in fact sheet D: the plays the tag selects (§4.1) and the task flow per action (§4.3).

Dependencies

Evidence

Before and after a run

  • fact sheet D §4.3: reconfigure = deploy: register, config, check-containers, bootstrap (DB, then bootstrap_manila), flush, then fix_cephfs_owner.yml when cephfs_native is enabled and the host is in manila-share.
  • fact sheet D §4.1: in the default inventory manila-share is a child of network, and the openvswitch children include manila-share; the OVS agent, openvswitch_db and openvswitch_vswitchd run on manila-share hosts only with the generic backend.
  • Reconfigure Neutron §2: -t neutron reconfigure runs the neutron play on neutron-server, every agent group, every compute and manila-share.
  • fact sheet D §4.6: Kolla does not create share types, the service image or networks.

Known limits and open points

  • fact sheet D §4.3: fix_cephfs_owner.yml runs on every deploy/reconfigure and mounts CephFS with secret=<keyring secret> on the command line. Security (NOT AVAILABLE): whether the secret appears in the process list and in Ansible logs at -v.
  • fact sheet D §4.6, "Operationally notable", three points: Kolla does not create share types, the service image or networks; the generic backend's service-instance credentials default to manila/manila; endpoints use kolla_internal_fqdn and kolla_external_fqdn directly.
  • fact sheet D §7, item 6: CephFS secret on the command line on every deploy; policy copy has no become; service-instance password defaults to manila; neutron host_in_groups for manila-share are asymmetric (OVS: generic only; LB: any backend).
  • fact sheet D §7, item 15: Barbican and other bootstraps (octavia, manila, ceilometer, masakari, zun, cyborg) re-run their DB sync container on every deploy/reconfigure.
  • F5, "reconfigure = deploy": a reconfigure re-runs Keystone registration, DB creation/grants and the DB-sync bootstrap containers of most services CODE.
  • What is not known: fact sheet D has its own NOT AVAILABLE list, and its §4.3 is among the sections that contain NOT AVAILABLE marks.
  • Known bugs and limitations, Open questions and Findings have no entry on Manila.

Service card

The rows of the card are explained on the Components page.

Item Value
Play site.yml:917
Tags manila
Play host patterns manila-api, manila-data, manila-share, manila-scheduler
Node types in play (example inventory) control, network
Node types running its containers control, network
Containers manila_api, manila_scheduler, manila_share, manila_data
deploy/reconfigure flow (tasks/deploy.yml) clone (if) → register → config → check-containers → bootstrap → flush handlers → fix_cephfs_owner (if)
Task files bootstrap.yml, bootstrap_service.yml, check-containers.yml, check.yml, clone.yml, config.yml, copy-certs.yml, deploy-containers.yml, deploy.yml, external_ceph.yml, fix_cephfs_owner.yml, loadbalancer.yml, main.yml, precheck.yml, pull.yml, reconfigure.yml, register.yml, stop.yml, upgrade.yml
Templates manila-api.json.j2, manila-data.json.j2, manila-scheduler.json.j2, manila-share.conf.j2, manila-share.json.j2, manila.conf.j2
Handlers (definition order) Restart manila-api container; Restart manila-data container; Restart manila-scheduler container; Restart manila-share container
Key variables enable_manila, enable_manila_backend_*
Role dependencies common (meta)
  • fact sheet D §4 — the per-role evidence: plays, services, task flow, config and dependencies
  • Neutron — the neutron play includes manila-share
  • Open vSwitch — the openvswitch group includes manila-share
  • Component dependencies §3 — Manila's config references Glance, Neutron, Nova, Cinder and Ceph (CephFS)
  • Components — the other component pages