cinder netapp #1

Supports: bionic focal groovy hirsute impish

Description

Cinder is the block storage service for the Openstack project. . This charm provides a netapp backend for Cinder


Overview

The cinder charm is the Openstack block storage (i.e: Volume) service, whereas the cinder-netapp charm works as a subordinate of cinder, implementing a backend based on NetApp.

Note: The cinder-netapp charm is supported starting with Openstack Queens.

Usage

Configuration

This section covers common and/or important configuration options. See file config.yaml for the full list of options, along with their descriptions and default values. See the Juju documentation for details on configuring applications.

netapp-storage-family

The storage family type that is used for the storage system. Can be ontap_cluster for clustering data ONTAP, or eseries.

netapp-storage-protocol

The SAN protocol to use. Can be either iscsi or NFS.

netapp-vserver

Specifies the virtual storage server name on the storage cluster.

netapp-server-hostname

The hostname or IP address for the storage server (can alternatively specify a proxy server).

netapp-server-port

The TCP port used to communicate with the storage server or proxy.

If it's not specified, it will be deduced: For ONTAP drivers, it will be 80 for HTTP and 443 for HTTPS; for E-series, it will be 8080 and 8443, respectively.

netapp-login

The username used to access the storage server or proxy.

netapp-password

The password used to authenticate the login option.

netapp-nfs-shares-config

Specifies a file that contains a list of NFS shares, each on its own line, to which the driver will attempt to provision Cinder volumes.

netapp-controller-ips

If the storage family is eseries, this option specifies a comma-separated list of controller hostnames or IP addresses to be used for provisioning.

netapp-array-password

The password for the NetApp E-series storage array.

netapp-storage-pools

Specifies a comma-separated list of pool names to use.

use-multipath

Whether to use multipath for image transfer.

netapp-enable-multiattach

Specifies whether the driver should allow operations that involve multiple attachments to a volume.

volume-backend-name

The service name to present to Cinder.

Deployment

This charm's primary use is as a backend for the cinder charm. To do so, add a relation betweeen both charms:

juju add-relation cinder-netapp:storage-backend cinder:storage-backend

Documentation

The OpenStack Charms project maintains two documentation guides:

Bugs

Please report bugs on Launchpad.


Configuration

netapp-array-password
(string) Password for the NetApp E-Series storage array.
netapp-controller-ips
(string) This option is only utilized when the storage family is configured to eseries. This option is used to restrict provisioning to the specified controllers. Specify the value of this option to be a comma separated list of controller hostnames or IP addresses to be used for provisioning.
netapp-enable-multiattach
(boolean) This option specifies whether the driver should allow operations that require multiple attachments to a volume. An example would be live migration of servers that have volumes attached. When enabled, this backend is limited to 256 total volumes in order to guarantee volumes can be accessed by more than one host.
netapp-login
(string) Administrative user account name used to access the storage system or proxy server.
netapp-lun-space-reservation
(boolean) This option determines if storage space is reserved for LUN allocation. If enabled, LUNs are thick provisioned. If space reservation is disabled, storage space is allocated on demand.
True
netapp-nfs-shares-config
(string) The file referenced by this configuration option should contain a list of NFS shares, each on their own line, to which the driver should attempt to provision new Cinder volumes into.
netapp-password
(string) Password for the administrative user account specified in the netapp_login option.
netapp-pool-name-search-pattern
(string) This option is used to restrict provisioning to the specified pools. Specify the value of this option to be a regular expression which will be applied to the names of objects from the storage backend which represent pools in Cinder. This option is only utilized when the storage protocol is configured to use iSCSI or FC.
netapp-server-hostname
(string) The hostname (or IP address) for the storage system or proxy server.
netapp-server-port
(int) The TCP port to use for communication with the storage system or proxy server. If not specified, Data ONTAP drivers will use 80 for HTTP and 443 for HTTPS; E-Series will use 8080 for HTTP and 8443 for HTTPS.
netapp-storage-family
(string) The storage family type used on the storage system; valid values are ontap_cluster for using clustered Data ONTAP, or eseries for using E-Series.
ontap_cluster
netapp-storage-protocol
(string) SAN protocol to use. Choose between iscsi or NFS.
iscsi
netapp-vserver
(string) This option specifies the virtual storage server (Vserver) name on the storage cluster on which provisioning of block storage volumes should occur.
use-multipath
(boolean) Use multipath for image transfer. The volume_use_multipath option should be set to True in the nova.conf
True
volume-backend-name
(string) Service name to present to Cinder
cinder_netapp