EqualLogic iSCSI setup script for VMware vSphere


Working for a Dell partner you can imagine that we sell and install a lot of EqualLogic Arrays. They have served their purpose very well in the small-medium size business arena very well in the last few years.  The “built in” model has become very popular for Dells EqualLogic line. Everything from Replication, Snapshots, Multipath Modules, etc comes with any EqualLogic array out of the box.  There are also technologies included for monitoring performance and capacity of your array(s), SAN HQ, as well as Application Consistent utilities for protection of SQL, Exchange, etc Autosnapshot Manager/Microsoft Edition and my favorite utility for vSphere, the Virtual Storage Manager Appliance.

Capture-EQL

Today I want to focus on easy setup using the VMware vMA Appliance or vSphere CLI.   A little know secret is that Dell includes a setup.pl script that can be used to configure your iSCSI vSwitch, vmnics, iSCSI vmk’s, port bindings, the software iSCSI HBA, etc.  It doesn’t stop there, however. Dell has recommended advanced configurations when using EqualLogic and vSphere to include enabling Jumbo Frames, setting DelayedAck off, increasing iSCSI login timeout settings, and finally turning off TCP offload.

When done manually in an environment this can get tedious as these are all Host Specific settings.

No worries, however.  Dell includes a setup.pl script in the MEM download package.  You can download the EqualLogic Multipathing Extension Module here. The latest version at the time of writing this is 1.2.   Of course you will need an EqualLogic support login and password which you can setup if you are a Partner or EqualLogic customer.

You will need a few things to get started depending on the route you select to install and setup iSCSI for your environment.  In this article, we will focus on using vSphere Update Manager to install the Multipathing Extension Module Extension, and a combination of vSphere CLI and the Setup.pl script included with the Dell MEM package, to complete the configuration of iSCSI.

You can certainly use the vMA if you’d like, and i’m sure you can use PowerCLI.  Unfortunately, I haven’t had the time to setup a PowerCLI script to do this as of yet.  You can also manually install the VIB for the Dell MEM as well if you wanted.  There are several ways of doing this, however, I have been using this method with great speed and efficiency so i’ll focus on how I do it. By all means, if you wanted to put the effort in to make this process more efficient, then I implore you to do so.

Things you’ll need to get started:

1. vSphere CLI (latest can be downloaded here – vSphere CLI 5.5.0U1)

2. Dell Multipathing Extension Module 1.2 (latest can be downloaded here – Dell MEM 1.2)

3. ESXi Host with available interfaces for iSCSI, should be preconfigured on the Switch side.  No other iSCSI configuration is required, the script will handle it on the host side.  (Remember, Dell validates and provides Tier 1 Support to only a certain set of Switches for EqualLogic Arrays.   There are also specific configurations which you can find on the Dell Rapid EqualLogic Configuration Portal)

After you have downloaded and extracted the .zip file you will see these files within:

Capture-mem

Let’s get to it.

– Install the vSphere CLI software that you downloaded above.  Very easy install, not going to screenshot it or go through the steps.  If you can’t install this software, I would say that you shouldn’t be doing this at all.

– After extracting the files from the Dell MEM .zip file, there will be another .zip file within the list of extracted files.  This is the VIB package containing the Multipathing Extension Module that will need to be installed on the host.  Upload this file via Update Manager.  Under the ADMIN view of Update Manager, go to PATCH REPOSITORY, and select IMPORT PATCHES.  Select the .zip file and import it into the repository:

Capture-patchrepository

Capture-patchrepository2

Now that you have the MEM Extension imported into the Patch Repository, you can now create an Extension Baseline and attach to the host(s):

Capture-Baseline

Capture-extension-add

Capture-extension-done

Now that the Extension Baseline is built we need to attach it to the hosts and run a SCAN operation against the Baseline.  This will allow us to REMEDIATE and install the Extension.  Now, I want to point out one thing here. There isn’t a reboot after installing this Extension and it IS needed which I will get to later.

Capture-baseline-attach

Capture-vum-mem

Capture-remediate-done

Now that the remediation is done, you should manually reboot your ESXi host. This will alleviate is issues later when we run the script and setup our iSCSI configuration per Dell EqualLogic best practice.

Let’s move on to the script. Earlier in this post, I showed you the files after the extraction of the Dell MEM download. In that folder is a file named setup.pl. You can copy this file anywhere you’d like on your PC that we will be running the script from. If you’re using the vMA, you can copy this to a directory in the vMA appliance.

After you have configured your iSCSI switch fabric, and determined what vmnic’s will be used for iSCSI as well as IP Addresses for the iSCSI vmk’s, we can run the script against your host(s).

Open up vSphere CLI. I like to go to the directory i’m running the script from because it’s less that you would need to type like putting the path for the script in first before you even get to the configuration.

There is a document within the extracted folder that outlines the script and the options if you want further detail.

To run the script:

setup.pl –sever=x.x.x.x –username=root –password=xxxx –configure –ips=x.x.x.x,x.x.x.x,x.x.x.x,x.x.x.x –nics=vmnicx,vmnicx,vmnicx,vmnicx –mtu=9000 –enableswiscsi –nohwiscsi –groupip=x.x.x.x

Let me explain all the x’s so you know what to input in those fields:

–server=IP OF HOST

–ips=IP’s of iSCSI vmk’s

–nics=iSCSI vmnics identified prior to this exercise

–groupip=IP of your EqualLogic Group (VIP for iSCSI connections)

After I run this on my test environment I get this output:

capture-eqlscript-mod

Here, you can see exactly what is happening when the script is running. It’s not only configuring your hosts for iSCSI but also EqualLogic recommended settings when using EqualLogic with vSphere. This saves a ton of time going from host to host to configure all of this. Here are the settings via the vSphere Client UI: (Note that the script example may not reflect the actual screenshots for the exact host, I just wanted to show the end state of a host for iSCSI configuration after the script was ran)

Creation of the vSwitch and vmk’s:

capture-iscsi-mod

Here you can see the proper Network Teaming with the NO Failback option:

Capture-iscsi-binding2

Configuration of the Software iSCSI Adapater:

capture-iscsi-binding-mod

capture-iscsi-dynamic-mod

Advanced option settings per EqualLogic recommendations with vSphere:

Capture-login

Capture-DelayedAck

Let’s run a query to validate the SATP and PSP for your Volumes:

capture-query-mod

There ya have it! Setting up iSCSI with the EqualLogic script and vSphere CLI. Comments and questions welcome.

2 thoughts on “EqualLogic iSCSI setup script for VMware vSphere

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s