Add docs for NetApp E-Series Cinder driver
This change adds the documentation for the NetApp E-Series Cinder driver, including details on the configuration options that were added to cinder.conf. Change-Id: Ic3e36970d894cf102831b72e78ed78490729322e Implements: blueprint netapp-eseries--cinder-driver
This commit is contained in:
parent
33a1777860
commit
a93463247d
@ -23,8 +23,8 @@
|
|||||||
<td>(IntOpt) This option specifies the threshold for last access time for images in the NFS image cache. When a cache cleaning cycle begins, images in the cache that have not been accessed in the last M minutes, where M is the value of this parameter, will be deleted from the cache to create free space on the NFS share.</td>
|
<td>(IntOpt) This option specifies the threshold for last access time for images in the NFS image cache. When a cache cleaning cycle begins, images in the cache that have not been accessed in the last M minutes, where M is the value of this parameter, will be deleted from the cache to create free space on the NFS share.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>netapp_copyoffload_tool = None</td>
|
<td>netapp_copyoffload_tool_path = None</td>
|
||||||
<td>(StrOpt) This option specifies the path of the NetApp Copy Offload tool binary. Ensure that the binary has execute permissions set which allow the effective user of the cinder-volume process to execute the file.</td>
|
<td>(StrOpt) This option specifies the path of the NetApp copy offload tool binary. Ensure that the binary has execute permissions set which allow the effective user of the cinder-volume process to execute the file.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>netapp_login = None</td>
|
<td>netapp_login = None</td>
|
||||||
|
63
doc/common/tables/cinder-netapp_eseries_iscsi.xml
Normal file
63
doc/common/tables/cinder-netapp_eseries_iscsi.xml
Normal file
@ -0,0 +1,63 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!-- Warning: Do not edit this file. It is automatically
|
||||||
|
generated and your changes will be overwritten.
|
||||||
|
The tool to do so lives in the tools directory of this
|
||||||
|
repository -->
|
||||||
|
<para xmlns="http://docbook.org/ns/docbook" version="5.0">
|
||||||
|
<table rules="all">
|
||||||
|
<caption>Description of configuration options for netapp_eseries_iscsi</caption>
|
||||||
|
<col width="50%"/>
|
||||||
|
<col width="50%"/>
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Configuration option = Default value</th>
|
||||||
|
<th>Description</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<th colspan="2">[DEFAULT]</th>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_controller_ips = None</td>
|
||||||
|
<td>(StrOpt) 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.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_login = None</td>
|
||||||
|
<td>(StrOpt) Administrative user account name used to access the storage system or proxy server.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_password = None</td>
|
||||||
|
<td>(StrOpt) Password for the administrative user account specified in the netapp_login option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_sa_password = None</td>
|
||||||
|
<td>(StrOpt) Password for the NetApp E-Series storage array.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_server_hostname = None</td>
|
||||||
|
<td>(StrOpt) The hostname (or IP address) for the storage system or proxy server.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_server_port = 80</td>
|
||||||
|
<td>(IntOpt) The TCP port to use for communication with the storage system or proxy server. Traditionally, port 80 is used for HTTP and port 443 is used for HTTPS; however, this value should be changed if an alternate port has been configured on the storage system or proxy server.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_storage_family = ontap_cluster</td>
|
||||||
|
<td>(StrOpt) The storage family type used on the storage system; valid values are ontap_7mode for using Data ONTAP operating in 7-Mode, ontap_cluster for using clustered Data ONTAP, or eseries for using E-Series.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_storage_pools = None</td>
|
||||||
|
<td>(StrOpt) This option is used to restrict provisioning to the specified storage pools. Only dynamic disk pools are currently supported. Specify the value of this option to be a comma separated list of disk pool names to be used for provisioning.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_transport_type = http</td>
|
||||||
|
<td>(StrOpt) The transport protocol used when communicating with the storage system or proxy server. Valid values are http or https.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>netapp_webservice_path = /devmgr/v2</td>
|
||||||
|
<td>(StrOpt) This option is used to specify the path to the E-Series proxy application on a proxy server. The value is combined with the value of the netapp_transport_type, netapp_server_hostname, and netapp_server_port options to create the URL used by the driver to connect to the proxy application.</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</para>
|
@ -3,14 +3,14 @@
|
|||||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
||||||
<title>NetApp unified driver</title>
|
<title>NetApp unified driver</title>
|
||||||
<para>The NetApp® unified driver is a block storage driver that
|
<para>The NetApp unified driver is a block storage driver that
|
||||||
supports multiple storage families and protocols. A storage
|
supports multiple storage families and protocols. A storage
|
||||||
family corresponds to storage systems built on different
|
family corresponds to storage systems built on different
|
||||||
NetApp technologies such as clustered Data ONTAP® and Data
|
NetApp technologies such as clustered Data ONTAP, Data ONTAP
|
||||||
ONTAP operating in 7-Mode. The storage protocol refers to the
|
operating in 7-Mode, and E-Series. The storage protocol refers
|
||||||
protocol used to initiate data storage and access operations
|
to the protocol used to initiate data storage and access
|
||||||
on those storage systems like iSCSI and NFS. The NetApp
|
operations on those storage systems like iSCSI and NFS. The
|
||||||
unified driver can be configured to provision and manage
|
NetApp unified driver can be configured to provision and manage
|
||||||
OpenStack volumes on a given storage family using a specified
|
OpenStack volumes on a given storage family using a specified
|
||||||
storage protocol. The OpenStack volumes can then be used for
|
storage protocol. The OpenStack volumes can then be used for
|
||||||
accessing and storing data using the storage protocol on the
|
accessing and storing data using the storage protocol on the
|
||||||
@ -22,7 +22,7 @@
|
|||||||
<para>The NetApp clustered Data ONTAP storage family
|
<para>The NetApp clustered Data ONTAP storage family
|
||||||
represents a configuration group which provides OpenStack
|
represents a configuration group which provides OpenStack
|
||||||
compute instances access to clustered Data ONTAP storage
|
compute instances access to clustered Data ONTAP storage
|
||||||
systems. At present it can be configured in Cinder to work
|
systems. At present it can be configured in OpenStack Block Storage to work
|
||||||
with iSCSI and NFS storage protocols.</para>
|
with iSCSI and NFS storage protocols.</para>
|
||||||
<section xml:id="ontap-cluster-iscsi">
|
<section xml:id="ontap-cluster-iscsi">
|
||||||
<title>NetApp iSCSI configuration for clustered Data
|
<title>NetApp iSCSI configuration for clustered Data
|
||||||
@ -33,7 +33,7 @@
|
|||||||
the SAN block storage entity; that is, a NetApp LUN
|
the SAN block storage entity; that is, a NetApp LUN
|
||||||
which can be accessed using the iSCSI protocol.</para>
|
which can be accessed using the iSCSI protocol.</para>
|
||||||
<para>The iSCSI configuration for clustered Data ONTAP is
|
<para>The iSCSI configuration for clustered Data ONTAP is
|
||||||
a direct interface from Cinder to the clustered Data
|
a direct interface from OpenStack Block Storage to the clustered Data
|
||||||
ONTAP instance and as such does not require additional
|
ONTAP instance and as such does not require additional
|
||||||
management software to achieve the desired
|
management software to achieve the desired
|
||||||
functionality. It uses NetApp APIs to interact with
|
functionality. It uses NetApp APIs to interact with
|
||||||
@ -44,24 +44,24 @@
|
|||||||
<para>Configure the volume driver, storage family and
|
<para>Configure the volume driver, storage family and
|
||||||
storage protocol to the NetApp unified driver,
|
storage protocol to the NetApp unified driver,
|
||||||
clustered Data ONTAP, and iSCSI respectively by
|
clustered Data ONTAP, and iSCSI respectively by
|
||||||
setting the <literal>volume_driver</literal>,
|
setting the <option>volume_driver</option>,
|
||||||
<literal>netapp_storage_family</literal> and
|
<option>netapp_storage_family</option> and
|
||||||
<literal>netapp_storage_protocol</literal>
|
<option>netapp_storage_protocol</option>
|
||||||
options in <filename>cinder.conf</filename> as
|
options in <filename>cinder.conf</filename> as
|
||||||
follows:</para>
|
follows:</para>
|
||||||
<programlisting language="ini">
|
<programlisting language="ini">
|
||||||
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
||||||
netapp_storage_family=ontap_cluster
|
netapp_storage_family=ontap_cluster
|
||||||
netapp_storage_protocol=iscsi
|
netapp_storage_protocol=iscsi
|
||||||
netapp_vserver=openstack-vserver
|
netapp_vserver=<replaceable>openstack-vserver</replaceable>
|
||||||
netapp_server_hostname=myhostname
|
netapp_server_hostname=<replaceable>myhostname</replaceable>
|
||||||
netapp_server_port=80
|
netapp_server_port=<replaceable>80</replaceable>
|
||||||
netapp_login=username
|
netapp_login=<replaceable>username</replaceable>
|
||||||
netapp_password=password
|
netapp_password=<replaceable>password</replaceable>
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<note>
|
<note>
|
||||||
<para>You must override the default value of
|
<para>You must override the default value of
|
||||||
<literal>netapp_storage_protocol</literal>
|
<option>netapp_storage_protocol</option>
|
||||||
with <literal>iscsi</literal> in order to
|
with <literal>iscsi</literal> in order to
|
||||||
utilize the iSCSI protocol.</para>
|
utilize the iSCSI protocol.</para>
|
||||||
</note>
|
</note>
|
||||||
@ -69,13 +69,13 @@
|
|||||||
href="../../../common/tables/cinder-netapp_cdot_iscsi.xml"/>
|
href="../../../common/tables/cinder-netapp_cdot_iscsi.xml"/>
|
||||||
<note>
|
<note>
|
||||||
<para>If you specify an account in the
|
<para>If you specify an account in the
|
||||||
<literal>netapp_login</literal> that only
|
<option>netapp_login</option> that only
|
||||||
has virtual storage server (Vserver)
|
has virtual storage server (Vserver)
|
||||||
administration privileges (rather than
|
administration privileges (rather than
|
||||||
cluster-wide administration privileges), some
|
cluster-wide administration privileges), some
|
||||||
advanced features of the NetApp unified driver
|
advanced features of the NetApp unified driver
|
||||||
will not work and you may see warnings in the
|
will not work and you may see warnings in the
|
||||||
Cinder logs.</para>
|
OpenStack Block Storage logs.</para>
|
||||||
</note>
|
</note>
|
||||||
<tip>
|
<tip>
|
||||||
<para>For more information on these options and
|
<para>For more information on these options and
|
||||||
@ -97,7 +97,7 @@
|
|||||||
clustered Data ONTAP system that are accessed using
|
clustered Data ONTAP system that are accessed using
|
||||||
the NFS protocol.</para>
|
the NFS protocol.</para>
|
||||||
<para>The NFS configuration for clustered Data ONTAP is a
|
<para>The NFS configuration for clustered Data ONTAP is a
|
||||||
direct interface from Cinder to the clustered Data
|
direct interface from OpenStack Block Storage to the clustered Data
|
||||||
ONTAP instance and as such does not require any
|
ONTAP instance and as such does not require any
|
||||||
additional management software to achieve the desired
|
additional management software to achieve the desired
|
||||||
functionality. It uses NetApp APIs to interact with
|
functionality. It uses NetApp APIs to interact with
|
||||||
@ -108,32 +108,32 @@
|
|||||||
<para>Configure the volume driver, storage family and
|
<para>Configure the volume driver, storage family and
|
||||||
storage protocol to NetApp unified driver,
|
storage protocol to NetApp unified driver,
|
||||||
clustered Data ONTAP, and NFS respectively by
|
clustered Data ONTAP, and NFS respectively by
|
||||||
setting the <literal>volume_driver</literal>,
|
setting the <option>volume_driver</option>,
|
||||||
<literal>netapp_storage_family</literal> and
|
<option>netapp_storage_family</option> and
|
||||||
<literal>netapp_storage_protocol</literal>
|
<option>netapp_storage_protocol</option>
|
||||||
options in <filename>cinder.conf</filename> as
|
options in <filename>cinder.conf</filename> as
|
||||||
follows:</para>
|
follows:</para>
|
||||||
<programlisting language="ini">
|
<programlisting language="ini">
|
||||||
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
||||||
netapp_storage_family=ontap_cluster
|
netapp_storage_family=ontap_cluster
|
||||||
netapp_storage_protocol=nfs
|
netapp_storage_protocol=nfs
|
||||||
netapp_vserver=openstack-vserver
|
netapp_vserver=<replaceable>openstack-vserver</replaceable>
|
||||||
netapp_server_hostname=myhostname
|
netapp_server_hostname=<replaceable>myhostname</replaceable>
|
||||||
netapp_server_port=80
|
netapp_server_port=<replaceable>80</replaceable>
|
||||||
netapp_login=username
|
netapp_login=<replaceable>username</replaceable>
|
||||||
netapp_password=password
|
netapp_password=<replaceable>password</replaceable>
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<xi:include
|
<xi:include
|
||||||
href="../../../common/tables/cinder-netapp_cdot_nfs.xml"/>
|
href="../../../common/tables/cinder-netapp_cdot_nfs.xml"/>
|
||||||
<note>
|
<note>
|
||||||
<para>If you specify an account in the
|
<para>If you specify an account in the
|
||||||
<literal>netapp_login</literal> that only
|
<option>netapp_login</option> that only
|
||||||
has virtual storage server (Vserver)
|
has virtual storage server (Vserver)
|
||||||
administration privileges (rather than
|
administration privileges (rather than
|
||||||
cluster-wide administration privileges), some
|
cluster-wide administration privileges), some
|
||||||
advanced features of the NetApp unified driver
|
advanced features of the NetApp unified driver
|
||||||
will not work and you may see warnings in the
|
will not work and you may see warnings in the
|
||||||
Cinder logs.</para>
|
OpenStack Block Storage logs.</para>
|
||||||
</note>
|
</note>
|
||||||
</simplesect>
|
</simplesect>
|
||||||
<simplesect>
|
<simplesect>
|
||||||
@ -167,23 +167,23 @@
|
|||||||
<para>In order to use this feature, the Image Service must be configured as follows:</para>
|
<para>In order to use this feature, the Image Service must be configured as follows:</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>default_store</literal> configuration option should be set to
|
<para>The <option>default_store</option> configuration option should be set to
|
||||||
<literal>file</literal></para>
|
<literal>file</literal></para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>filesystem_store_datadir</literal> configuration option should be set to
|
<para>The <option>filesystem_store_datadir</option> configuration option should be set to
|
||||||
the path to the the Image Service NFS export</para>
|
the path to the the Image Service NFS export</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>show_image_direct_url</literal> configuration option should be set to
|
<para>The <option>show_image_direct_url</option> configuration option should be set to
|
||||||
<literal>True</literal></para>
|
<literal>True</literal></para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>show_multiple_locations</literal> configuration option should be set to
|
<para>The <option>show_multiple_locations</option> configuration option should be set to
|
||||||
<literal>True</literal></para>
|
<literal>True</literal></para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>filesystem_store_metadata_file</literal> configuration option
|
<para>The <option>filesystem_store_metadata_file</option> configuration option
|
||||||
should refer to a metadata file. The metadata file should contain a
|
should refer to a metadata file. The metadata file should contain a
|
||||||
JSON object that contains the correct information about the NFS export
|
JSON object that contains the correct information about the NFS export
|
||||||
used by the Image Service, similar to:</para>
|
used by the Image Service, similar to:</para>
|
||||||
@ -199,11 +199,11 @@
|
|||||||
<para>In order to use this feature, the Block Storage Service must be configured as follows:</para>
|
<para>In order to use this feature, the Block Storage Service must be configured as follows:</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>netapp_copyoffload_tool</literal> configuration option should be set to
|
<para>The <option>netapp_copyoffload_tool_path</option> configuration option should be set to
|
||||||
the path to the NetApp Copy Offload binary</para>
|
the path to the NetApp Copy Offload binary</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <literal>glance_api_version</literal> configuration option should be set to
|
<para>The <option>glance_api_version</option> configuration option should be set to
|
||||||
<literal>2</literal></para>
|
<literal>2</literal></para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
@ -227,7 +227,7 @@
|
|||||||
</important>
|
</important>
|
||||||
<tip>
|
<tip>
|
||||||
<para>To download the NetApp copy offload binary to be utilized
|
<para>To download the NetApp copy offload binary to be utilized
|
||||||
in conjunction with the <literal>netapp_copyoffload_tool_path</literal>
|
in conjunction with the <option>netapp_copyoffload_tool_path</option>
|
||||||
configuration option, please visit the Downloads section of
|
configuration option, please visit the Downloads section of
|
||||||
the <link xlink:href="http://support.netapp.com/">NetApp
|
the <link xlink:href="http://support.netapp.com/">NetApp
|
||||||
support site</link>.</para>
|
support site</link>.</para>
|
||||||
@ -248,18 +248,18 @@
|
|||||||
determines which volume node should fulfill a volume
|
determines which volume node should fulfill a volume
|
||||||
provisioning request. When you use the NetApp unified
|
provisioning request. When you use the NetApp unified
|
||||||
driver with a clustered Data ONTAP storage system, you
|
driver with a clustered Data ONTAP storage system, you
|
||||||
can leverage extra specs with Cinder volume types to
|
can leverage extra specs with OpenStack Block Storage volume types to
|
||||||
ensure that Cinder volumes are created on storage back
|
ensure that OpenStack Block Storage volumes are created on storage back
|
||||||
ends that have certain properties. For example, when
|
ends that have certain properties. For example, when
|
||||||
you configure QoS, mirroring, or compression for a
|
you configure QoS, mirroring, or compression for a
|
||||||
storage back end.</para>
|
storage back end.</para>
|
||||||
<para>Extra specs are associated with Cinder volume types,
|
<para>Extra specs are associated with OpenStack Block Storage volume types,
|
||||||
so that when users request volumes of a particular
|
so that when users request volumes of a particular
|
||||||
volume type, the volumes are created on storage back
|
volume type, the volumes are created on storage back
|
||||||
ends that meet the list of requirements. For example,
|
ends that meet the list of requirements. For example,
|
||||||
the back ends have the available space or extra specs.
|
the back ends have the available space or extra specs.
|
||||||
You can use the specs in the following table when you
|
You can use the specs in the following table when you
|
||||||
define Cinder volume types by using the
|
define OpenStack Block Storage volume types by using the
|
||||||
<command>cinder type-key</command> command.</para>
|
<command>cinder type-key</command> command.</para>
|
||||||
<xi:include
|
<xi:include
|
||||||
href="../../../common/tables/cinder-netapp_cdot_extraspecs.xml"/>
|
href="../../../common/tables/cinder-netapp_cdot_extraspecs.xml"/>
|
||||||
@ -268,7 +268,7 @@
|
|||||||
specs to <literal>True</literal> when combining
|
specs to <literal>True</literal> when combining
|
||||||
multiple specs to enforce a certain logic set. If
|
multiple specs to enforce a certain logic set. If
|
||||||
you desire to remove volumes with a certain
|
you desire to remove volumes with a certain
|
||||||
feature enabled from consideration from the Cinder
|
feature enabled from consideration from the OpenStack Block Storage
|
||||||
volume scheduler, be sure to use the negated spec
|
volume scheduler, be sure to use the negated spec
|
||||||
name with a value of <literal>True</literal>
|
name with a value of <literal>True</literal>
|
||||||
rather than setting the positive spec to a value
|
rather than setting the positive spec to a value
|
||||||
@ -282,7 +282,7 @@
|
|||||||
<para>The NetApp Data ONTAP operating in 7-Mode storage family
|
<para>The NetApp Data ONTAP operating in 7-Mode storage family
|
||||||
represents a configuration group which provides OpenStack
|
represents a configuration group which provides OpenStack
|
||||||
compute instances access to 7-Mode storage systems. At
|
compute instances access to 7-Mode storage systems. At
|
||||||
present it can be configured in Cinder to work with iSCSI
|
present it can be configured in OpenStack Block Storage to work with iSCSI
|
||||||
and NFS storage protocols.</para>
|
and NFS storage protocols.</para>
|
||||||
<section xml:id="ontap-7mode-iscsi">
|
<section xml:id="ontap-7mode-iscsi">
|
||||||
<title>NetApp iSCSI configuration for Data ONTAP operating
|
<title>NetApp iSCSI configuration for Data ONTAP operating
|
||||||
@ -308,23 +308,23 @@
|
|||||||
storage protocol to the NetApp unified driver,
|
storage protocol to the NetApp unified driver,
|
||||||
Data ONTAP operating in 7-Mode, and iSCSI
|
Data ONTAP operating in 7-Mode, and iSCSI
|
||||||
respectively by setting the
|
respectively by setting the
|
||||||
<literal>volume_driver</literal>,
|
<option>volume_driver</option>,
|
||||||
<literal>netapp_storage_family</literal> and
|
<option>netapp_storage_family</option> and
|
||||||
<literal>netapp_storage_protocol</literal>
|
<option>netapp_storage_protocol</option>
|
||||||
options in <filename>cinder.conf</filename> as
|
options in <filename>cinder.conf</filename> as
|
||||||
follows:</para>
|
follows:</para>
|
||||||
<programlisting language="ini">
|
<programlisting language="ini">
|
||||||
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
||||||
netapp_storage_family=ontap_7mode
|
netapp_storage_family=ontap_7mode
|
||||||
netapp_storage_protocol=iscsi
|
netapp_storage_protocol=iscsi
|
||||||
netapp_server_hostname=myhostname
|
netapp_server_hostname=<replaceable>myhostname</replaceable>
|
||||||
netapp_server_port=80
|
netapp_server_port=<replaceable>80</replaceable>
|
||||||
netapp_login=username
|
netapp_login=<replaceable>username</replaceable>
|
||||||
netapp_password=password
|
netapp_password=<replaceable>password</replaceable>
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<note>
|
<note>
|
||||||
<para>You must override the default value of
|
<para>You must override the default value of
|
||||||
<literal>netapp_storage_protocol</literal>
|
<option>netapp_storage_protocol</option>
|
||||||
with <literal>iscsi</literal> in order to
|
with <literal>iscsi</literal> in order to
|
||||||
utilize the iSCSI protocol.</para>
|
utilize the iSCSI protocol.</para>
|
||||||
</note>
|
</note>
|
||||||
@ -350,7 +350,7 @@
|
|||||||
storage system which can then be accessed using NFS
|
storage system which can then be accessed using NFS
|
||||||
protocol.</para>
|
protocol.</para>
|
||||||
<para>The NFS configuration for Data ONTAP operating in
|
<para>The NFS configuration for Data ONTAP operating in
|
||||||
7-Mode is a direct interface from Cinder to the Data
|
7-Mode is a direct interface from OpenStack Block Storage to the Data
|
||||||
ONTAP operating in 7-Mode instance and as such does
|
ONTAP operating in 7-Mode instance and as such does
|
||||||
not require any additional management software to
|
not require any additional management software to
|
||||||
achieve the desired functionality. It uses NetApp
|
achieve the desired functionality. It uses NetApp
|
||||||
@ -364,19 +364,19 @@
|
|||||||
storage protocol to the NetApp unified driver,
|
storage protocol to the NetApp unified driver,
|
||||||
Data ONTAP operating in 7-Mode, and NFS
|
Data ONTAP operating in 7-Mode, and NFS
|
||||||
respectively by setting the
|
respectively by setting the
|
||||||
<literal>volume_driver</literal>,
|
<option>volume_driver</option>,
|
||||||
<literal>netapp_storage_family</literal> and
|
<option>netapp_storage_family</option> and
|
||||||
<literal>netapp_storage_protocol</literal>
|
<option>netapp_storage_protocol</option>
|
||||||
options in <filename>cinder.conf</filename> as
|
options in <filename>cinder.conf</filename> as
|
||||||
follows:</para>
|
follows:</para>
|
||||||
<programlisting language="ini">
|
<programlisting language="ini">
|
||||||
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
||||||
netapp_storage_family=ontap_7mode
|
netapp_storage_family=ontap_7mode
|
||||||
netapp_storage_protocol=nfs
|
netapp_storage_protocol=nfs
|
||||||
netapp_server_hostname=myhostname
|
netapp_server_hostname=<replaceable>myhostname</replaceable>
|
||||||
netapp_server_port=80
|
netapp_server_port=<replaceable>80</replaceable>
|
||||||
netapp_login=username
|
netapp_login=<replaceable>username</replaceable>
|
||||||
netapp_password=password
|
netapp_password=<replaceable>password</replaceable>
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<xi:include
|
<xi:include
|
||||||
href="../../../common/tables/cinder-netapp_7mode_nfs.xml"/>
|
href="../../../common/tables/cinder-netapp_7mode_nfs.xml"/>
|
||||||
@ -390,6 +390,74 @@
|
|||||||
</simplesect>
|
</simplesect>
|
||||||
</section>
|
</section>
|
||||||
</section>
|
</section>
|
||||||
|
<section xml:id="eseries-family">
|
||||||
|
<title>NetApp E-Series storage family</title>
|
||||||
|
<para>The NetApp E-Series storage family represents a
|
||||||
|
configuration group which provides OpenStack
|
||||||
|
compute instances access to E-Series storage systems.
|
||||||
|
At present it can be configured in OpenStack Block Storage to work
|
||||||
|
with the iSCSI storage protocol.</para>
|
||||||
|
<section xml:id="eseries-iscsi">
|
||||||
|
<title>NetApp iSCSI configuration for E-Series</title>
|
||||||
|
<para>The NetApp iSCSI configuration for E-Series
|
||||||
|
is an interface from OpenStack to E-Series storage
|
||||||
|
systems for provisioning and managing the SAN block
|
||||||
|
storage entity; that is, a NetApp LUN which can be
|
||||||
|
accessed using the iSCSI protocol.</para>
|
||||||
|
<para>The iSCSI configuration for E-Series is an interface
|
||||||
|
from OpenStack Block Storage to the E-Series proxy instance and as such
|
||||||
|
requires the deployment of the proxy instance in order to
|
||||||
|
achieve the desired functionality. The driver uses REST
|
||||||
|
APIs to interact with the E-Series proxy instance, which in
|
||||||
|
turn interacts directly with the E-Series controllers.</para>
|
||||||
|
<simplesect>
|
||||||
|
<title>Configuration options for E-Series storage
|
||||||
|
family with iSCSI protocol</title>
|
||||||
|
<para>Configure the volume driver, storage family and
|
||||||
|
storage protocol to the NetApp unified driver,
|
||||||
|
E-Series, and iSCSI respectively by setting the
|
||||||
|
<option>volume_driver</option>,
|
||||||
|
<option>netapp_storage_family</option> and
|
||||||
|
<option>netapp_storage_protocol</option>
|
||||||
|
options in <filename>cinder.conf</filename> as
|
||||||
|
follows:</para>
|
||||||
|
<programlisting language="ini">
|
||||||
|
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
|
||||||
|
netapp_storage_family=eseries
|
||||||
|
netapp_storage_protocol=iscsi
|
||||||
|
netapp_server_hostname=<replaceable>myhostname</replaceable>
|
||||||
|
netapp_server_port=<replaceable>80</replaceable>
|
||||||
|
netapp_login=<replaceable>username</replaceable>
|
||||||
|
netapp_password=<replaceable>password</replaceable>
|
||||||
|
netapp_controller_ips=<replaceable>1.2.3.4,5.6.7.8</replaceable>
|
||||||
|
netapp_sa_password=<replaceable>arrayPassword</replaceable>
|
||||||
|
netapp_storage_pools=<replaceable>pool1,pool2</replaceable>
|
||||||
|
</programlisting>
|
||||||
|
<note>
|
||||||
|
<para>You must override the default value of
|
||||||
|
<option>netapp_storage_family</option>
|
||||||
|
with <literal>eseries</literal> in order to
|
||||||
|
utilize the E-Series driver.</para>
|
||||||
|
</note>
|
||||||
|
<note>
|
||||||
|
<para>You must override the default value of
|
||||||
|
<option>netapp_storage_protocol</option>
|
||||||
|
with <literal>iscsi</literal> in order to
|
||||||
|
utilize the iSCSI protocol.</para>
|
||||||
|
</note>
|
||||||
|
<xi:include
|
||||||
|
href="../../../common/tables/cinder-netapp_eseries_iscsi.xml"/>
|
||||||
|
<tip>
|
||||||
|
<para>For more information on these options and
|
||||||
|
other deployment and operational scenarios,
|
||||||
|
visit the <link
|
||||||
|
xlink:href="https://communities.netapp.com/groups/openstack"
|
||||||
|
> OpenStack NetApp
|
||||||
|
community.</link></para>
|
||||||
|
</tip>
|
||||||
|
</simplesect>
|
||||||
|
</section>
|
||||||
|
</section>
|
||||||
<section xml:id="ontap-unified-upgrade-deprecated">
|
<section xml:id="ontap-unified-upgrade-deprecated">
|
||||||
<title>Upgrading prior NetApp drivers to the NetApp unified
|
<title>Upgrading prior NetApp drivers to the NetApp unified
|
||||||
driver</title>
|
driver</title>
|
||||||
@ -402,7 +470,7 @@
|
|||||||
deprecated NetApp drivers.</para>
|
deprecated NetApp drivers.</para>
|
||||||
<section xml:id="ontap-unified-upgrade">
|
<section xml:id="ontap-unified-upgrade">
|
||||||
<title>Upgraded NetApp drivers</title>
|
<title>Upgraded NetApp drivers</title>
|
||||||
<para>This section describes how to update Cinder
|
<para>This section describes how to update OpenStack Block Storage
|
||||||
configuration from a pre-Havana release to the new
|
configuration from a pre-Havana release to the new
|
||||||
unified driver format.</para>
|
unified driver format.</para>
|
||||||
<simplesect>
|
<simplesect>
|
||||||
|
@ -149,18 +149,22 @@ nas_login nas
|
|||||||
nas_password nas
|
nas_password nas
|
||||||
nas_private_key nas
|
nas_private_key nas
|
||||||
nas_ssh_port nas
|
nas_ssh_port nas
|
||||||
netapp_copyoffload_tool netapp_cdot_nfs
|
netapp_controller_ips netapp_eseries_iscsi
|
||||||
netapp_login netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_copyoffload_tool_path netapp_cdot_nfs
|
||||||
netapp_password netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_login netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs netapp_eseries_iscsi
|
||||||
netapp_server_hostname netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_password netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs netapp_eseries_iscsi
|
||||||
netapp_server_port netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_sa_password netapp_eseries_iscsi
|
||||||
|
netapp_server_hostname netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs netapp_eseries_iscsi
|
||||||
|
netapp_server_port netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs netapp_eseries_iscsi
|
||||||
netapp_size_multiplier netapp_7mode_iscsi netapp_cdot_iscsi
|
netapp_size_multiplier netapp_7mode_iscsi netapp_cdot_iscsi
|
||||||
netapp_storage_family netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_storage_family netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs netapp_eseries_iscsi
|
||||||
|
netapp_storage_pools netapp_eseries_iscsi
|
||||||
netapp_storage_protocol netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_storage_protocol netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
||||||
netapp_transport_type netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_transport_type netapp_7mode_iscsi netapp_7mode_nfs netapp_cdot_iscsi netapp_cdot_nfs netapp_eseries_iscsi
|
||||||
netapp_vfiler netapp_7mode_iscsi
|
netapp_vfiler netapp_7mode_iscsi
|
||||||
netapp_volume_list netapp_7mode_iscsi
|
netapp_volume_list netapp_7mode_iscsi
|
||||||
netapp_vserver netapp_cdot_iscsi netapp_cdot_nfs
|
netapp_vserver netapp_cdot_iscsi netapp_cdot_nfs
|
||||||
|
netapp_webservice_path netapp_eseries_iscsi
|
||||||
nexenta_blocksize nexenta_iscsi
|
nexenta_blocksize nexenta_iscsi
|
||||||
nexenta_host nexenta_iscsi
|
nexenta_host nexenta_iscsi
|
||||||
nexenta_iscsi_target_portal_port nexenta_iscsi
|
nexenta_iscsi_target_portal_port nexenta_iscsi
|
||||||
|
Loading…
Reference in New Issue
Block a user