openstack-manuals/doc/config-reference/block-storage/drivers/hp-lefthand-driver.xml
Diane Fleming 64b6c9261e Folder rename, file rename, flattening of directories
Current folder name	New folder name	        Book title
----------------------------------------------------------
basic-install 	        DELETE
cli-guide	        DELETE
common	                common
NEW	                admin-guide-cloud	Cloud Administrators Guide
docbkx-example	        DELETE
openstack-block-storage-admin 	DELETE
openstack-compute-admin 	DELETE
openstack-config 	config-reference	OpenStack Configuration Reference
openstack-ha 	        high-availability-guide	OpenStack High Availabilty Guide
openstack-image	        image-guide	OpenStack Virtual Machine Image Guide
openstack-install 	install-guide	OpenStack Installation Guide
openstack-network-connectivity-admin 	admin-guide-network 	OpenStack Networking Administration Guide
openstack-object-storage-admin 	DELETE
openstack-security 	security-guide	OpenStack Security Guide
openstack-training 	training-guide	OpenStack Training Guide
openstack-user 	        user-guide	OpenStack End User Guide
openstack-user-admin 	user-guide-admin	OpenStack Admin User Guide
glossary	        NEW        	OpenStack Glossary

bug: #1220407

Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7
author: diane fleming
2013-09-08 15:15:50 -07:00

88 lines
3.9 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 &amp; 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 backend.</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>
<simplesect>
<title>Configuring the VSA</title>
<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>
<para>
<orderedlist>
<listitem>
<para>Configure Chap on each of the <systemitem
class="service">nova-compute</systemitem>
nodes.</para>
</listitem>
<listitem>
<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>
</listitem>
</orderedlist>
</para>
</simplesect>
</section>