EMC VNX direct driverUse the EMC VNX direct driver to create, attach, detach, and
delete volumes, create and delete snapshots, and so on. This driver
is based on the Cinder-defined ISCSIDriver driver.
To complete volume operations, the driver uses the NaviSec
command-line interface (CLI) to communicate with back-end EMC VNX
storage.
System requirementsFlare version 5.32 or later.You must activate VNX Snapshot and Thin Provisioning license
for the array. Ensure that all the iSCSI ports from the
VNX are accessible through OpenStack hosts.Navisphere CLI v7.32 or later.EMC storage VNX Series are supported.Supported operationsCreate, delete, attach, and detach volumes.Create, list, and delete volume snapshots.Create a volume from a snapshot.Copy an image to a volume.Copy a volume to an image.Clone a volume.Extend a volume.Set up the VNX direct driverComplete these high-level tasks to set up the VNX direct driver:
Install NaviSecCLI. You must install the NaviSecCLI
tool on the controller node and all the Cinder nodes in
an OpenStack deployment. See .
Register with VNX. See Install NaviSecCLIOn Ubuntu x64, download the NaviSecCLI deb package from EMC's OpenStack GitHub web site.
For all the other variants of Linux, download the NaviSecCLI rpm package from EMC's support web site for VNX2 series or VNX1 series. Login is required.
Register with VNXTo export a VNX volume to a compute node or a volume node,
you must register the node with VNX.To register the nodeOn the compute node or volume node 1.1.1.1, do
the following (assume 10.10.61.35
is the iSCSI target):#/etc/init.d/open-iscsi start#iscsiadm -m discovery -t st -p 10.10.61.35#cd /etc/iscsi#more initiatorname.iscsi#iscsiadm -m nodeLog in to VNX from the node using the target
corresponding to the SPA port:#iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.a0 -p 10.10.61.35 -lWhere
iqn.1992-04.com.emc:cx.apm01234567890.a0
is the initiator name of the node. Login to
Unisphere, go to
VNX00000->Hosts->Initiators,
Refresh and wait until initiator
iqn.1992-04.com.emc:cx.apm01234567890.a0
with SP Port A-8v0 appears.Click Register,
select CLARiiON/VNX,
and enter the host name myhost1 and
IP address myhost1. Click Register.
Now host 1.1.1.1 also appears under
Hosts->Host List.Log out of VNX on the node:#iscsiadm -m node -uLog in to VNX from the node using the target
corresponding to the SPB port:#iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.b8 -p 10.10.10.11 -lIn Unisphere register the initiator with the SPB
port.Log out:#iscsiadm -m node -ucinder.conf configuration
fileMake the following changes in
/etc/cinder/cinder.conf.For the VNX iSCSI driver, add the following entries, where
10.10.61.35 is the IP address
of the VNX iSCSI target, 10.10.72.41
is the IP address of the VNX array (SPA or SPB),
default_timeout is the default
time out for CLI operations in minutes, and
max_luns_per_storage_group is
the default max number of LUNs in a storage group:
iscsi_ip_address = 10.10.61.35
san_ip = 10.10.72.41
san_login = global_username
san_password = password
naviseccli_path = /opt/Navisphere/bin/naviseccli
storage_vnx_pool_name = poolname
default_timeout = 10
max_luns_per_storage_group=256
volume_driver=cinder.volume.drivers.emc.emc_cli_iscsi.EMCCLIISCSIDriver
To find out max_luns_per_storage_group
for each VNX model, refer to the
EMC's support web site (login is required).
Restart the cinder-volume service.Volume type supportVolume type support allows user to choose thick/thin
provisioning capabilities.Here is an example of how to setup volume type.
First create volume types. Then define extra specs for
each volume type.To set up volume typesSetup volume types:$cinder type-create "TypeA"$cinder type-create "TypeB"Setup volume type extra specs:$cinder type-key "TypeA" set storagetype:provisioning=thick$cinder type-key "TypeB" set storagetype:provisioning=thinThe previous example creates two volume types:
TypeA and TypeB.
For TypeA, storagetype:provisioning
is set to thick. Similarly
for TypeB, storagetype:provisioning
is set to thin. If
storagetype:provisioning is not specified, it will be
default to thick.