openstack-ansible/doc/source/install-guide/configure-cinder.rst
Jean-Philippe Evrard 4bf2a1f37c Cinder_volumes_containers are automatically tagged with is_metal
In env.d/cinder.yml there is is_metal:true. 
But there was no mention of it in the documentation.
Therefore, if an user wants to use a cinder volume container with 
netapp/ceph/whatever, the container will be (by default) 
considered as metal.
This should be documented somewhere.

Change-Id: I65e9d0654d50d8c8825f858e89fdf4595134dddb
2015-08-13 12:00:49 +01:00

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