d40a4d6f14
The volume type extra spec storagetype:storageprofile can now be used to allow volumes to be created with Storage Profiles other than the default. This patch adds documentation around what this feature is and how to configure it using the extra specs. This documents a new feature for Liberty. Backport: none Change-Id: I042a8db4b53ae7b5ab0f136ceeb6e8b09734c5e1 Depends-On: Icf76fceca5a0ae20bb08b276b0c41ef6cdb31087
145 lines
5.6 KiB
XML
145 lines
5.6 KiB
XML
<?xml version="1.0"?>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xml:id="dell-storagecenter-driver" version="5.0">
|
|
<title>Dell Storage Center Fibre Channel and iSCSI drivers</title>
|
|
<para>The Dell Storage Center volume driver interacts with configured
|
|
Storage Center arrays.</para>
|
|
<para>The Dell Storage Center driver manages Storage Center arrays through
|
|
Enterprise Manager. Enterprise Manager connection settings and Storage
|
|
Center options are defined in the <filename>cinder.conf</filename> file.
|
|
</para>
|
|
<para>
|
|
Prerequisite: Dell Enterprise Manager 2015 R1 or later must be used.
|
|
</para>
|
|
<simplesect>
|
|
<title>Supported operations</title>
|
|
<para>The Dell Storage Center volume driver provides the following
|
|
Cinder volume operations:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Create, delete, attach (map), and detach (unmap) volumes.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Create, list, and delete volume snapshots.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Create a volume from a snapshot.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Copy an image to a volume.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Copy a volume to an image.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Clone a volume.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Extend a volume.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Extra spec options</title>
|
|
<para>Volume type extra specs can be used to select different Storage
|
|
Profiles.</para>
|
|
<para>Storage Profiles control how Storage Center manages volume data.
|
|
For a given volume, the selected Storage Profile dictates which disk
|
|
tier accepts initial writes, as well as how data progression moves data
|
|
between tiers to balance performance and cost. Predefined Storage
|
|
Profiles are the most effective way to manage data in Storage
|
|
Center.</para>
|
|
<para>By default, if no Storage Profile is specified in the volume extra
|
|
specs, the default Storage Profile for the user account configured for
|
|
the Block Storage driver is used. The extra spec key
|
|
<literal>storagetype:storageprofile</literal> with the value of the name
|
|
of the Storage Profile on the Storage Center can be set to allow to use
|
|
Storage Profiles other than the default.</para>
|
|
<para>For ease of use from the command line, spaces in Storage Profile
|
|
names are ignored. As an example, here is how to define two volume
|
|
types using the <literal>High Priority</literal> and <literal>Low
|
|
Priority</literal> Storage Profiles:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder type-create "GoldVolumeType"</userinput>
|
|
<prompt>$</prompt> <userinput>cinder type-key "GoldVolumeType" set storagetype:storageprofile=highpriority</userinput>
|
|
<prompt>$</prompt> <userinput>cinder type-create "BronzeVolumeType"</userinput>
|
|
<prompt>$</prompt> <userinput>cinder type-key "BronzeVolumeType" set storagetype:storageprofile=lowpriority</userinput></screen>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>iSCSI configuration</title>
|
|
<para>Use the following instructions to update the configuration
|
|
file for iSCSI:
|
|
<example><title>Sample iSCSI Configuration</title>
|
|
<programlisting language="ini">default_volume_type = delliscsi
|
|
enabled_backends = delliscsi
|
|
|
|
[delliscsi]
|
|
# Name to give this storage backend
|
|
volume_backend_name = delliscsi
|
|
# The iSCSI driver to load
|
|
volume_driver = cinder.volume.drivers.dell.dell_storagecenter_iscsi.DellStorageCenterISCSIDriver
|
|
# IP address of Enterprise Manager
|
|
san_ip = 172.23.8.101
|
|
# Enterprise Manager user name
|
|
san_login = Admin
|
|
# Enterprise Manager password
|
|
san_password = secret
|
|
# The Storage Center iSCSI IP address
|
|
iscsi_ip_address = 192.168.0.20
|
|
# The Storage Center serial number to use
|
|
dell_sc_ssn = 64702
|
|
|
|
# ==Optional settings==
|
|
# The Enterprise Manager API port
|
|
dell_sc_api_port = 3033
|
|
# Server folder to place new server definitions
|
|
dell_sc_server_folder = devstacksrv
|
|
# Volume folder to place created volumes
|
|
dell_sc_volume_folder = devstackvol/Cinder
|
|
# The iSCSI IP port
|
|
iscsi_port = 3260</programlisting>
|
|
</example>
|
|
</para>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Fibre Channel configuration</title>
|
|
<para>Use the following instructions to update the configuration
|
|
file for fibre channel:
|
|
<example><title>Sample FC configuration</title>
|
|
<programlisting language="ini">default_volume_type = dellfc
|
|
enabled_backends = dellfc
|
|
|
|
[dellfc]
|
|
# Name to give this storage backend
|
|
volume_backend_name = dellfc
|
|
# The FC driver to load
|
|
volume_driver = cinder.volume.drivers.dell.dell_storagecenter_fc.DellStorageCenterFCDriver
|
|
# IP address of Enterprise Manager
|
|
san_ip = 172.23.8.101
|
|
# Enterprise Manager user name
|
|
san_login = Admin
|
|
# Enterprise Manager password
|
|
san_password = secret
|
|
# The Storage Center serial number to use
|
|
dell_sc_ssn = 64702
|
|
|
|
# Optional settings
|
|
|
|
# The Enterprise Manager API port
|
|
dell_sc_api_port = 3033
|
|
# Server folder to place new server definitions
|
|
dell_sc_server_folder = devstacksrv
|
|
# Volume folder to place created volumes
|
|
dell_sc_volume_folder = devstackvol/Cinder</programlisting>
|
|
</example>
|
|
</para>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Driver options</title>
|
|
<para>The following table contains the configation options specific to the
|
|
Dell Storage Center volume driver.</para>
|
|
<xi:include href="../../../common/tables/cinder-dellsc.xml"/>
|
|
</simplesect>
|
|
</section>
|