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

3.7 KiB

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. 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.