How to deploy cinder with EMC plug-in

^{The following guide describe how to steps to configure and deploy cinder with EMC plug-in.}

Intro:

Cinder is responsible for management of block storage in openstack, and handles volume management related tasks. Cinder supports different volume drivers, those drivers allows creation and modification of volumes directly on related storage Vendor (type). in our case, EMC driver.

note that configuration is not that strait-forward, so please make sure to follow all steps required.

Setup:

- Cinder machine installed with RHEL6.4

 * note: we are using basic AIO topology

- Dedicated physical machine installed with RHEL6.4 (64bit)

 * note: this machine will be used to host the SMI-S agent

- EMC storage (we are using EMC VNX5300)

  * address of both SPA and SPB controllers 
  * user and password for both controllers 
  * dedicated storage pool (in our example: call it - "OpenStack")

Configuration:

Storage (EMC) machine:

- create a new storage pool with name "OpenStack"

SMI-S machine:

- install the following packages

   * yum install -y libgcc_s.so.1 glibc.i686 *pywbem* compat-libstdc++-33.x86_64

- download SMI-S (solution provider) from EMC site and install it (kit name: se7510-Linux-i386-SMI.tar) - unpack and install SMI-S agent:

   * tar -xvf se7510-Linux-i386-SMI.tar
   * ./se7510_install.sh -install -host

- deploy SMI-S agent and configure storage Array

  * cd /opt/emc/ECIM/ECOM/bin/
  *  ./TestSmiProvider 
     (localhost:5988) ? addsys
     Add System {y|n} [n]: y
     ArrayType (1=Clar, 2=Symm) [1]: 
     One or more IP address or Hostname or Array ID
     Elements for Addresses
     IP address or hostname or array id 0 (blank to quit): 10.35.160.102
     IP address or hostname or array id 1 (blank to quit): 10.35.160.103
     IP address or hostname or array id 2 (blank to quit): 
     Address types corresponding to addresses specified above.
     (1=URL, 2=IP/Nodename, 3=Array ID) 
     Address Type (0) [default=2]: 
     Address Type (1) [default=2]: 
     User [null]: sysadmin 
     Password [null]: sysadmin
     ++++ EMCAddSystem ++++
     OUTPUT : 7
     Legend:0=Success, 1=Not Supported, 2=Unknown, 3=Timeout, 4=Failed
      5=Invalid Parameter
      4096=Job Queued, 4097=Size Not Supported
     Note: Not all above values apply to all methods - see MOF for the method.

Cinder machine:

- perform the following configuration changes:

  * edit /etc/cinder/cinder.conf and add the following configuration:
       iscsi_target_prefix = iqn.1992-04.com.emc
       iscsi_ip_address = 1.1.1.104
       volume_driver = cinder.volume.drivers.emc.emc_smis_iscsi.EMCSMISISCSIDriver
       cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml

  * create the following file and append the following configuration:
      <?xml version='1.0' encoding='UTF-8'?>
      <EMC>
      <StorageType>OpenStack</StorageType>
      <EcomServerIp>1.1.1.10</EcomServerIp>
      <EcomServerPort>5985</EcomServerPort>
      <EcomUserName>admin</EcomUserName>
      <EcomPassword>#1Password</EcomPassword>
      </EMC

- restart cinder volume service

    * /etc/init.d/openstack-cinder-volume restart