{"id":20111428,"url":"https://github.com/openstack/charm-manila-netapp","last_synced_at":"2026-02-12T09:32:11.267Z","repository":{"id":66174681,"uuid":"349319331","full_name":"openstack/charm-manila-netapp","owner":"openstack","description":"Juju Charm - Manila-NetApp Backend. Mirror of code maintained at opendev.org.","archived":false,"fork":false,"pushed_at":"2025-10-30T14:32:56.000Z","size":68,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-10-30T16:39:18.637Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://opendev.org/openstack/charm-manila-netapp","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-03-19T06:09:09.000Z","updated_at":"2025-10-30T14:33:01.000Z","dependencies_parsed_at":"2023-11-07T09:29:44.765Z","dependency_job_id":"c36e45a8-4ec8-4d81-9c81-bf1db3bb36f7","html_url":"https://github.com/openstack/charm-manila-netapp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/openstack/charm-manila-netapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fcharm-manila-netapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fcharm-manila-netapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fcharm-manila-netapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fcharm-manila-netapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openstack","download_url":"https://codeload.github.com/openstack/charm-manila-netapp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fcharm-manila-netapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29362799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T18:16:02.301Z","updated_at":"2026-02-12T09:32:11.252Z","avatar_url":"https://github.com/openstack.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Manila NetApp Backend Source Charm\n\n## Overview\n\nThis charm provides NetApp Clustered Data ONTAP as a storage backend for\nManila, OpenStack's shared filesystem service. It is written using the Juju\n[operator][operator-git-repo] framework.\n\n## Usage\n\nThe charm relies on the principal Manila charm, and is a subordinate to it. It\nprovides configuration data to the `manila-share` service (which is provided by\nthe Manila charm with a role that includes 'share').\n\nPrior to deploying this charm, a NetApp Data ONTAP cluster must be configured.\nIt also needs L3 connectivity between the storage cluster and the Manila\nservices. See the OpenStack [driver documentation][driver-doc] with details\nabout the NetApp Clustered Data ONTAP driver, and known restrictions.\n\nIf multiple, _different_, NetApp backend configurations are required, then the\n`share-backend-name` config option should be used to differentiate between the\nconfiguration sections.\n\n_Note_: This subordinate charm requests that Manila principal charm configures\nthe Neutron conf file section, that the NetApp driver needs to allocate ports\nfor the storage vms when the `driver-handles-share-servers` config is enabled.\nThe principal charm provides the _main_ Manila service username/password to\nthis charm to enable it to provide this section.\n\nWhen `driver-handles-share-servers` is enabled, the driver will launch\nstorage vms (SMVs) within the NetApp Data ONTAP cluster. With this mode enabled,\nManila requires a [share network][share-networks-doc] to be defined.\n\nA Manila share network is bound to a Neutron network and subnet. During a\nshare creation, the NetApp driver will allocate a port in the Neutron subnet\nattached to the share network, and use that as the static IP for the SVM\nspawned into NetApp Data ONTAP cluster. The only limitation to this mode is\nthat the Neutron network bound to the share network, needs to be `flat` or\n`vlan`, when using the NetApp driver.\n\nWith DHSS (driver handles share servers) enabled, the `CIFS` share servers must\nbe configured with an external Active Directory (AD) for authentication. The AD\nconfig info is provided to the Manila NetApp share servers via an\n`active_directory` [security service][security-services-doc] associated with\nthe share network.\n\nAlso, the NetApp driver requires credentials from an AD user with enough\nprivileges to register the new `CIFS` share servers as computers in the AD\ndomain. These credentials are provided as part of the Manila security service\nconfiguration.\n\n**WARNING**: The credentials for the required AD user are stored in plain text,\nin the Manila database, as part of the associated security service. Tenant\nusers are able to see these when fetching information about the\n`active_directory` security service. This is a potential security risk!\n\nWhen `driver-handles-share-servers` is disabled, an existing NetApp ONTAP\nSVM must be pre-configured, and its name must be given as `vserver-name` in\nthe charm config.\n\n## Building the charm\n\nTo build the charm run the following command in the root of the repository:\n\n```bash\n$ tox -e build\n```\n\nThe resultant built charm will be `manila-netapp.charm`.\n\n## Deployment\n\nOne way to deploy Manila NetApp is to use a bundle overlay when deploying\nOpenStack via a bundle:\n\n```bash\njuju deploy ./base.yaml --overlay ./manila-netapp-overlay.yaml\n```\n\nThe Manila NetApp bundle overlay might look like:\n\n```yaml\napplications:\n  manila-netapp:\n    options:\n      driver-handles-share-servers: False\n      vserver-name: svm0\n      management-address: 10.1.1.10\n      admin-name: admin\n      admin-password: my-secret-admin-password\n```\n\n## Bugs\n\nPlease report bugs on [Launchpad][lp-bugs-charm-manila-netapp].\n\nFor general charm questions refer to the OpenStack [Charm Guide][cg].\n\n\u003c!-- LINKS --\u003e\n\n[cg]: https://docs.openstack.org/charm-guide\n[driver-doc]: https://docs.openstack.org/manila/victoria/configuration/shared-file-systems/drivers/netapp-cluster-mode-driver.html\n[share-networks-doc]: https://docs.openstack.org/manila/victoria/admin/shared-file-systems-share-networks.html\n[security-services-doc]: https://docs.openstack.org/manila/victoria/admin/shared-file-systems-security-services.html\n[lp-bugs-charm-manila-netapp]: https://bugs.launchpad.net/charm-manila-netapp/+filebug\n[operator-git-repo]: https://github.com/canonical/operator\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenstack%2Fcharm-manila-netapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenstack%2Fcharm-manila-netapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenstack%2Fcharm-manila-netapp/lists"}