openstack-manuals/doc/config-reference/block-storage/drivers/prophetstor-dpl-driver.xml

120 lines
5.2 KiB
XML

<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="prophetstor-dpl-driver">
<title>ProphetStor Fibre Channel and iSCSI drivers</title>
<para>ProhetStor Fibre Channel and iSCSI drivers add support for
ProphetStor Flexvisor through OpenStack Block Storage. ProphetStor
Flexvisor enables commodity x86 hardware as software-defined storage
leveraging well-proven ZFS for disk management to provide enterprise
grade storage services such as snapshots, data protection with
different RAID levels, replication, and deduplication.</para>
<para>The <literal>DPLFCDriver</literal> and
<literal>DPLISCSIDriver</literal> drivers run
volume operations by communicating with the ProphetStor storage
system over HTTPS.</para>
<section xml:id="prophetstor-dpl-driver-ops">
<title>Supported operations</title>
<itemizedlist>
<listitem>
<para>Create, delete, attach, and detach 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>
</section>
<section xml:id="enable-prophetstor-dpl-iscsi-fb">
<title>Enable the Fibre Channel or iSCSI drivers</title>
<para>The <literal>DPLFCDriver</literal> and
<literal>DPLISCSIDriver</literal> are installed
with the OpenStack software.</para>
<procedure>
<step>
<para>Query storage pool id for configure <literal>dpl_pool</literal> of the
<filename>cinder.conf</filename>.</para>
<substeps>
<step>
<para>Logon onto the storage system with administrator
access.</para>
<screen><prompt>$</prompt> <userinput>ssh root@<replaceable>STORAGE IP ADDRESS</replaceable></userinput></screen>
</step>
<step>
<para>View the current usable pool id.</para>
<screen><prompt>$</prompt> <userinput>flvcli show pool list</userinput>
<computeroutput>- d5bd40b58ea84e9da09dcf25a01fdc07 : default_pool_dc07</computeroutput></screen>
</step>
<step>
<para>Use <literal>d5bd40b58ea84e9da09dcf25a01fdc07</literal>
to config the <literal>dpl_pool</literal> of <filename>/etc/cinder/cinder.conf</filename>.</para>
</step>
</substeps>
<note>
<para>Other management command can reference by command help <command>flvcli -h</command>.</para>
</note>
</step>
<step>
<para>Make the following changes on the volume node
<filename>/etc/cinder/cinder.conf</filename>
file.</para>
<programlisting language="ini"># IP address of SAN controller (string value)
san_ip=<replaceable>STORAGE IP ADDRESS</replaceable>
# Username for SAN controller (string value)
san_login=<replaceable>USERNAME</replaceable>
# Password for SAN controller (string value)
san_password=<replaceable>PASSWORD</replaceable>
# Use thin provisioning for SAN volumes? (boolean value)
san_thin_provision=true
# The port that the iSCSI daemon is listening on. (integer value)
iscsi_port=3260
# DPL pool uuid in which DPL volumes are stored. (string value)
dpl_pool=d5bd40b58ea84e9da09dcf25a01fdc07
# DPL port number. (integer value)
dpl_port=8357
# Uncomment one of the next two option to enable Fibre channel or iSCSI
# FIBRE CHANNEL(uncomment the next line to enable the FC driver)
#volume_driver=cinder.volume.drivers.prophetstor.dpl_fc.DPLFCDriver
# iSCSI (uncomment the next line to enable the iSCSI driver)
#volume_driver=cinder.volume.drivers.prophetstor.dpl_iscsi.DPLISCSIDriver</programlisting>
</step>
<step>
<para>Save the changes to the
<filename>/etc/cinder/cinder.conf</filename> file and
restart the <systemitem class="service"
>cinder-volume</systemitem> service.</para>
</step>
</procedure>
<para>The ProphetStor Fibre Channel or iSCSI drivers are now
enabled on your OpenStack system. If you experience
problems, review the Block Storage service log files for
errors.</para>
<para>The following table contains the options supported
by the ProphetStor storage driver.</para>
<xi:include
href="../../../common/tables/cinder-prophetstor_dpl.xml"/>
</section>
</section>