openstack-ansible/doc/source/install-guide/configure-cinder.rst

Home OpenStack-Ansible Installation Guide

Configuring the Block Storage service (optional)

configure-cinder-nfs.rst configure-cinder-backup.rst configure-cinder-az.rst

By default, the Block Storage service uses the LVM back end. Therefore the container hosting the Block Storage service has to be considered as is_metal.

If you rather use another backend (like NetApp, Ceph, etc.) in a container instead of bare metal, you may edit the /etc/openstack_deploy/env.d/cinder.yml and remove the is_metal: true stanza under the cinder_volumes_container properties.

To use a NetApp storage appliance back end, edit the /etc/openstack_deploy/openstack_user_config.yml file and configure each storage node that will use it:

Ensure that the NAS Team enables httpd.admin.access.

1. Add the netapp stanza under the cinder_backends stanza for each storage node:

   cinder_backends:
     netapp:

   The options in subsequent steps fit under the netapp stanza.

   The back end name is arbitrary and becomes a volume type within the Block Storage service.

2. Configure the storage family:

   netapp_storage_family: STORAGE_FAMILY

   Replace STORAGE_FAMILY with ontap_7mode for Data ONTAP operating in 7-mode or ontap_cluster for Data ONTAP operating as a cluster.

3. Configure the storage protocol:

   netapp_storage_protocol: STORAGE_PROTOCOL

   Replace STORAGE_PROTOCOL with iscsi for iSCSI or nfs for NFS.

   For the NFS protocol, you must also specify the location of the configuration file that lists the shares available to the Block Storage service:

   nfs_shares_config: SHARE_CONFIG

   Replace SHARE_CONFIG with the location of the share configuration file. For example, /etc/cinder/nfs_shares.

4. Configure the server:

   netapp_server_hostname: SERVER_HOSTNAME

   Replace SERVER_HOSTNAME with the hostnames for both netapp controllers.

5. Configure the server API port:

   netapp_server_port: PORT_NUMBER

   Replace PORT_NUMBER with 80 for HTTP or 443 for HTTPS.

6. Configure the server credentials:

   netapp_login: USER_NAME
   netapp_password: PASSWORD

   Replace USER_NAME and PASSWORD with the appropriate values.

7. Select the NetApp driver:

   volume_driver: cinder.volume.drivers.netapp.common.NetAppDriver

8. Configure the volume back end name:

   volume_backend_name: BACKEND_NAME

   Replace BACKEND_NAME with a suitable value that provides a hint for the Block Storage scheduler. For example, NETAPP_iSCSI.

9. Check that the openstack_user_config.yml configuration is accurate:

   storage_hosts:
     xxxxxx-Infra01:
       ip: 172.29.236.16
       container_vars:
         cinder_backends:
           limit_container_types: cinder_volume
           netapp:
             netapp_storage_family: ontap_7mode
             netapp_storage_protocol: nfs
             netapp_server_hostname: 111.222.333.444
             netapp_server_port: 80
             netapp_login: openstack_cinder
             netapp_password: password
             volume_driver: cinder.volume.drivers.netapp.common.NetAppDriver
             volume_backend_name: NETAPP_NFS

   For netapp_server_hostname, specify the IP address of the Data ONTAP server. Include iSCSI or NFS for the netapp_storage_family depending on the configuration. Add 80 if using HTTP or 443 if using HTTPS for netapp_server_port.

   The cinder-volume.yml playbook will automatically install the nfs-common file across the hosts, transitioning from an LVM to a NetApp back end.

---