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¶
- Dependencies: Component dependencies §3
Evidence¶
- Fact sheet: fact sheet D §4
- Image side: Kolla images
§4 (row
manila-api), Kolla images §5
Before and after a run¶
- fact sheet D §4.3:
reconfigure=deploy: register, config, check-containers, bootstrap (DB, thenbootstrap_manila), flush, thenfix_cephfs_owner.ymlwhen cephfs_native is enabled and the host is in manila-share. - fact sheet D §4.1: in the default
inventory
manila-shareis a child ofnetwork, and theopenvswitchchildren includemanila-share; the OVS agent,openvswitch_dbandopenvswitch_vswitchdrun on manila-share hosts only with the generic backend. - Reconfigure Neutron §2:
-t neutron reconfigureruns the neutron play onneutron-server, every agent group, every compute andmanila-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.ymlruns on every deploy/reconfigure and mounts CephFS withsecret=<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 usekolla_internal_fqdnandkolla_external_fqdndirectly. - fact sheet D
§7, item
6: CephFS secret on the command line on every deploy; policy copy has no
become; service-instance password defaults tomanila; neutronhost_in_groupsfor 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/) |
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) |
Related¶
- 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
openvswitchgroup includesmanila-share - Component dependencies §3 — Manila's config references Glance, Neutron, Nova, Cinder and Ceph (CephFS)
- Components — the other component pages