b417259465
Partial-Bug: #1250515 author: diane fleming Change-Id: I92c9ad25ee5bbd2c9334c4860637faa1b358718b backport: havana
82 lines
3.6 KiB
XML
82 lines
3.6 KiB
XML
<section xml:id="HPSan-driver" 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">
|
|
<title>HP / LeftHand SAN</title>
|
|
<para>HP/LeftHand SANs are optimized for virtualized environments
|
|
with VMware ESX & Microsoft Hyper-V, though the OpenStack
|
|
integration provides additional support to various other
|
|
virtualized environments, such as Xen, KVM, and OpenVZ, by
|
|
exposing the volumes through ISCSI to connect to the
|
|
instances.</para>
|
|
<para>The HpSanISCSIDriver enables you to use a HP/Lefthand SAN
|
|
that supports the Cliq interface. Every supported volume
|
|
operation translates into a cliq call in the back-end.</para>
|
|
<para>To use Cinder with HP/Lefthand SAN, you must set the
|
|
following parameters in the <filename>cinder.conf</filename>
|
|
file:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Set
|
|
<parameter>volume_driver=cinder.volume.drivers.san.HpSanISCSIDriver</parameter>.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Set <parameter>san_ip</parameter> flag to the
|
|
hostname or VIP of your Virtual Storage Appliance
|
|
(VSA).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Set <parameter>san_login</parameter> and
|
|
<parameter>san_password</parameter> to the user
|
|
name and password of the ssh user with all necessary
|
|
privileges on the appliance.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Set <code>san_ssh_port=16022</code>. The default is
|
|
22. However, the default for the VSA is usually
|
|
16022.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Set <code>san_clustername</code> to the name of the
|
|
cluster where the associated volumes are
|
|
created.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>The following optional parameters have the following default
|
|
values:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><code>san_thin_provision=True</code>. To disable
|
|
thin provisioning, set to <literal>False</literal>.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><code>san_is_local=False</code>. Typically, this
|
|
parameter is set to <literal>False</literal> for this
|
|
driver. To configure the cliq commands to run locally
|
|
instead of over ssh, set this parameter to
|
|
<literal>True</literal>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>In addition to configuring the <systemitem class="service"
|
|
>cinder-volume</systemitem> service, you must configure
|
|
the VSA to function in an OpenStack environment.</para>
|
|
<procedure>
|
|
<title>To configure the VSA</title>
|
|
<step>
|
|
<para>Configure Chap on each of the <systemitem
|
|
class="service">nova-compute</systemitem>
|
|
nodes.</para>
|
|
</step>
|
|
<step>
|
|
<para>Add Server associations on the VSA with the
|
|
associated Chap and initiator information. The name
|
|
should correspond to the <emphasis role="italic"
|
|
>'hostname'</emphasis> of the <systemitem
|
|
class="service">nova-compute</systemitem> node.
|
|
For Xen, this is the hypervisor host name. To do this,
|
|
use either Cliq or the Centralized Management
|
|
Console.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|