4bf2a1f37c
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
145 lines
4.0 KiB
ReStructuredText
145 lines
4.0 KiB
ReStructuredText
`Home <index.html>`__ OpenStack Ansible Installation Guide
|
|
|
|
Configuring the Block Storage service (optional)
|
|
------------------------------------------------
|
|
|
|
.. toctree::
|
|
|
|
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.
|
|
|
|
#. Add the ``netapp`` stanza under the ``cinder_backends`` stanza for
|
|
each storage node:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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.
|
|
|
|
#. Configure the storage family:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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.
|
|
|
|
#. Configure the storage protocol:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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:
|
|
|
|
.. code-block:: yaml
|
|
|
|
nfs_shares_config: SHARE_CONFIG
|
|
|
|
Replace *``SHARE_CONFIG``* with the location of the share
|
|
configuration file. For example, ``/etc/cinder/nfs_shares``.
|
|
|
|
#. Configure the server:
|
|
|
|
.. code-block:: yaml
|
|
|
|
netapp_server_hostname: SERVER_HOSTNAME
|
|
|
|
Replace *``SERVER_HOSTNAME``* with the hostnames for both netapp
|
|
controllers.
|
|
|
|
#. Configure the server API port:
|
|
|
|
.. code-block:: yaml
|
|
|
|
netapp_server_port: PORT_NUMBER
|
|
|
|
Replace *``PORT_NUMBER``* with 80 for HTTP or 443 for HTTPS.
|
|
|
|
#. Configure the server credentials:
|
|
|
|
.. code-block:: yaml
|
|
|
|
netapp_login: USER_NAME
|
|
netapp_password: PASSWORD
|
|
|
|
Replace *``USER_NAME``* and *``PASSWORD``* with the appropriate
|
|
values.
|
|
|
|
#. Select the NetApp driver:
|
|
|
|
.. code-block:: yaml
|
|
|
|
volume_driver: cinder.volume.drivers.netapp.common.NetAppDriver
|
|
|
|
#. Configure the volume back end name:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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``.
|
|
|
|
#. Check that the ``openstack_user_config.yml`` configuration is
|
|
accurate:
|
|
|
|
.. code-block:: yaml
|
|
|
|
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.
|
|
|
|
--------------
|
|
|
|
.. include:: navigation.txt
|