HOW TO: Add an iSCSI Software Adaptor and Create an iSCSI Multipath Network in VMware vSphere Hypervisor ESXi 4.1

AID: 9209
  • Status: Published

10207 points

  • Byhanccocka
  • TypeTutorial
  • Posted on2012-01-14 at 13:18:52
Using a software based iSCSI solution, there is no requirement to purchase an hardware iSCSI initiator or TOE (TCP/IP Offload Engine) interface card. A standard network interface card, can be used to connect and existing ESXi server to a remote iSCSI target or iSCSI SAN on the TCP/IP storage network. The iSCSI Software Adapter built into the VMKenerl interface, completes the communication between the network interface card and the host server network stack.

This tutorial can be used to add an iSCSI Software Adapter and create an iSCSI Multipath Network in VMware vSphere Hypervisor ESXi 4.1.

1

Connect to the VMware vSphere Hypervisor (ESXi 4.1) Server



Using the VMware vSphere Client, login and connect to the ESXi 4.1 server, using IP address or hostname of the ESXi 4.1 server, using root username and password credentials. If you have a VMware vSphere vCenter server, you could also specify IP address or hostname of the vCenter server which manages your vSphere 4 ESXi 4.1 server.

VMware-vSphere-Client2.jpg
  • 26 KB
  • Using the VMware vSphere Client, login and connect to the ESXi 4.1 server
Using the VMware vSphere Client, login and connect to the ESXi 4.1 server


2

Select and Configure the Storage Adapters for the ESXi server



When connected to the ESXi server, select the Host Server, Configuration tab, and select Storage Adapters. Please note, if you do not have any persistent storage connected to the ESXi server, a yellow warning configuration box will appear. This example server used in this tutorial does not have any local SAS or SATA storage connected. Once the iSCSI Software Adapter has been added, iSCSI storage can be added, and this yellow warning configuration box will disappear.

Storage-Adaptors.jpg
  • 104 KB
  • select Storage Adaptors
select Storage Adaptors


the procedure for adding and configuring the iSCSI Software Adapter is slightly different, depending upon which version of the vSphere Client (version 4.1.0 or version 5.0.0) you have installed, if the iSCSI Software Adapter is not visible as shown in the following screenshot, it's likely you have connected using the vSphere Client version 5.0.0. Skip Step 3 and proceed to Step 4.

Storage-Adaptors1.jpg
  • 72 KB
  • Storage Adaptors iSCSI software Adaptor not visible
Storage Adaptors iSCSI software Adaptor not visible


3

Configuring the iSCSI Software Adapter using the vSphere Client version 4.1.0



Scroll down, and select iSCSI Software Adapter, and Select Properties

 
iSCSI-Software-Adaptor.jpg
  • 33 KB
  • elect iSCSI Software Adaptor, and Select Properties
elect iSCSI Software Adaptor, and Select Properties


The iSCSI Initiator (iSCSI Software Adapter) Properties dialogue page will appear. Please note the status of the current Software Initiator is Disabled.

Select Configure

 


The General Properties diaglogue box, will appear, select, click and ensure a Tick is present next to Enabled, to Enable the iSCSI Software Adapter and Click OK.

General-Properties.jpg
  • 12 KB
  • Tick is present next to Enabled
Tick is present next to Enabled


The iSCSI Initiator (vmba33) Properties will appear. Note that Software Initiator Properties should have changed to Enabled, and the iSCSI Properties Name is populated with an iSCSI Initiator Name.

 
iSCSI-Iniator-vmhba33-Properties.jpg
  • 29 KB
  • iSCSI Initiator (vmba33) Properties
iSCSI Initiator (vmba33) Properties


In this example the iSCSI initiator name is

iqn.1998-01.com.vmware:esxdev007-2e9c906d


The iSCSI initiator adapter name is vmba33.

Please record both the iSCSI Initiator Name and the adapter name, these will be important for you in the future, it will be needed when you assign storage to this initiator. The adapter name is required later in this procedure to complete VMKernel bindings.

Click Close to proceed. Skip Step 4, and Proceed to Step 5.

4

(Adding) and Configuring the iSCSI Software Adapter using the vSphere Client version 5.0.0



Click Add in Storage Adapters

Add-iSCSI-Storage-Adaptor.jpg
  • 93 KB
  • Select Add Software iSCSI Adapter and Click OK
Select Add Software iSCSI Adapter and Click OK


Select Add Software iSCSI Adapter and Click OK. The following prompt will be displayed.

Software-iSCSI-Adaptor.jpg
  • 55 KB
  • Software iSCSI Adapter added
Software iSCSI Adapter added


Scroll down, and select iSCSI Software Adapter, and Select Properties

 
iSCSI-Software-Adaptor.jpg
  • 33 KB
  • elect iSCSI Software Adaptor, and Select Properties
elect iSCSI Software Adaptor, and Select Properties


The iSCSI Initiator (iSCSI Software Adapter) Properties dialogue page will appear. Please note the status of the current Software Initiator is Disabled.

Select Configure

 


The General Properties diaglogue box, will appear, select, click and ensure a Tick is present next to Enabled, to Enable the iSCSI Software Adapter and Click OK.

General-Properties.jpg
  • 12 KB
  • Tick is present next to Enabled
Tick is present next to Enabled


The iSCSI Initiator (vmba33) Properties will appear. Note that Software Initiator Properties should have changed to Enabled, and the iSCSI Properties Name is populated with an iSCSI Initiator Name.

 
iSCSI-Iniator-vmhba33-Properties.jpg
  • 29 KB
  • iSCSI Initiator (vmba33) Properties
iSCSI Initiator (vmba33) Properties


In this example the iSCSI initiator name is

iqn.1998-01.com.vmware:esxdev007-2e9c906d


The iSCSI initiator adapter name is vmba33.

Please record both the iSCSI Initiator Name and the adapter name, these will be important for you in the future, it will be needed when you assign storage to this initiator. The adapter name is required later in this procedure to complete VMKernel bindings.

Click Close to proceed. .


5

Create a new vSwitch (virtual switch) and add VMKernel Portgroups



The VMKernel TCP/IP stack Portgroup handles traffic for the following ESXi services iSCSI, NFS, VMware vMotion and host management. To create a multipath iSCSI network at least two VMKernel TCP/IP stack Portgroups needed to be created on a virtual switch.

Select the Host Server, Configuration tab, and select Networking.

vSwitch1.jpg
  • 89 KB
  • Add new vSwitch
Add new vSwitch


Select Add Networking to add a new vSwitch (virtual switch). Select VMKernel followed by Next

Add-Network-Wizard.jpg
  • 37 KB
  • Add Networking Wizard
Add Networking Wizard


Create a new virtual switch with at least two physical network interfaces connections for use with multipath. I've selected vmnic2 and vmnic3, followed by Next.

VMkernel-Network-Access.jpg
  • 49 KB
  • new virtual switch
new virtual switch


Enter a network friendly network label for the VMkernel iSCSI Portgroup 1 - VMkernel iSCSI Network 1, followed by Next

VMkernel---Connection-Settings.jpg
  • 45 KB
  • VMkernel Connection Settings
VMkernel Connection Settings


Enter an IP address for the first VMkernel iSCSI Portgroup 1, followed by Next

VMkernel---IP-Connection-Setting.jpg
  • 40 KB
  • VMkernel - IP Connecting Settings
VMkernel - IP Connecting Settings


Review the vSwitch configuration is correct and click Finish

VMkernel---Finished.jpg
  • 35 KB
  • Review the vSwitch configuration
Review the vSwitch configuration


Review the vSwitch created

 
New-vSwitch1.jpg
  • 9 KB
  • New vSwitch1 created
New vSwitch1 created
 

Select Properties of the vSwitch and Click Add

vSwitch1-Properties.jpg
  • 43 KB
  • vSwitch1 Properties
vSwitch1 Properties


Add another VMkernel Portgroup, Select VMKernel followed by Next

Add-Network-Wizard.jpg
  • 37 KB
  • Add Networking Wizard
Add Networking Wizard


Enter a network friendly network label for the VMkernel iSCSI Portgroup 2 - VMkernel iSCSI Network 2, followed by Next

 
VMkernel---Connection-Settings1.jpg
  • 46 KB
  • VMkernel Connection Settings
VMkernel Connection Settings


Enter an IP address for the first VMkernel iSCSI Portgroup 2, followed by Next

 
VMkernel---IP-Connection-Setting.jpg
  • 43 KB
  • VMkernel - IP Connecting Settings
VMkernel - IP Connecting Settings


Review the vSwitch configuration is correct and click Finish and Close.

 
VMkernel---Finished1.jpg
  • 35 KB
  • Review the vSwitch configuration
Review the vSwitch configuration


Review the Final vSwitch created, with two VMkernel Portgroups

vSwitch1a.jpg
  • 13 KB
  • vSwitch1 complete with two VMkernel Portgroups
vSwitch1 complete with two VMkernel Portgroups


The two VMkernel portgroups have been added, and the vSwitch configuration is almost complete.

6

VMkernel Portgroup - Override vSwitch failover order



In this section we need to override the switch failover order for each VMkernel portgroup as follows

VMkernel iSCSI Network 1 - Active Network interface vmnic2 - Unused Network Interface vmnic3

VMkernel iSCSI Network 2 - Active Network interface vmnic3 - Unused Network Interface vmnic2

Select Properties of the vSwitch created in Step 5.

 
vSwitch1a.jpg
  • 14 KB
  • Select Properties of vSwitch1
Select Properties of vSwitch1


vSwitch1 properties will be displayed. Select the VMkernel iSCSI Network 1 portgroup to edit

 
vSwitch1-Properties1.jpg
  • 49 KB
  • edit VMkernel portgroup
edit VMkernel portgroup


Select NIC Teaming

 
NIC-Teaming.jpg
  • 25 KB
  • Select NIC Teaming
Select NIC Teaming


Select and put a tick in Override vSwitch Failover order and select the network interface e.g. vmnic3 to move down to Unused adapters

vSwitch-override.jpg
  • 54 KB
  • vSwitch Override
vSwitch Override


This is how override vSwitch failover should look for VMkernel iSCSI Network 1

vSwitch-override1.jpg
  • 54 KB
  • vSwitch Override for VMkernel iSCSI Network 1
vSwitch Override for VMkernel iSCSI Network 1


Click OK. We now need to repeat the same steps for VMkernel iSCSI Network 2 Select the VMkernel iSCSI Network 2 portgroup to edit

vSwitch-override2.jpg
  • 49 KB
  • vSwitch Override for VMkernel iSCSI Network 2
vSwitch Override for VMkernel iSCSI Network 2


Select NIC Teaming

NIC-Teaming1.jpg
  • 25 KB
  • Select NIC Teaming
Select NIC Teaming


Select and put a tick in Override vSwitch Failover order and select the network interface e.g. vmnic2 to move down to Unused adapters

vSwitch-override2a.jpg
  • 54 KB
  • vSwitch Override for VMkernel iSCSI Network 2
vSwitch Override for VMkernel iSCSI Network 2


This is how override vSwitch failover should look for VMkernel iSCSI Network 2

vSwitch-override2b.jpg
  • 54 KB
  • vSwitch Override for VMkernel iSCSI Network 2
vSwitch Override for VMkernel iSCSI Network 2


Click OK, followed by close, override vSwitch failover has been completed for the vSwitch. VMKernels are now bound to specific network interfaces, as follows

VMkernel iSCSI Network 1 - Active Network interface vmnic2 - Unused Network Interface vmnic3

VMkernel iSCSI Network 2 - Active Network interface vmnic3 - Unused Network Interface vmnic2

The final and remaining step is to bind these with the software iSCSI iniatiator (adapter). The The iSCSI Initiator adapter name is vmba33. (from Step 3).
.
7

Bind physical network interfaces (pNIC) to the iSCSI VMKernel



This step is often forgotten, and requires login at the console or remotely via SSH to the ESXi server. The VMware vSphere CLI can also be used with the esxcli.exe command to set the bindings if you prefer to use the vSphere CLI.

Using PuTTY a free telnet and SSH client or another SSH client Login and Connect to the VMware Hypervisor ESXi server, using IP address or hostname of the VMware Hypervisor ESXi server, using root username and password credentials.

 
SSH-terminalsession.jpg
  • 6 KB
  • putty SSH terminal session
putty SSH terminal session


 
SSH-terminalsession1.jpg
  • 28 KB
  • logged in as root to ssh terminal session
logged in as root to ssh terminal session


at the console or SSH session type the following commands

esxcli swiscsi nic add -n vmk1 -d vmhba33

esxcli swiscsi nic add -n vmk2 -d vmhba33


No syntax is output if the commands are correct

esxcli-swiscsi.jpg
  • 6 KB
  • esxcli swiscsi
esxcli swiscsi


You have added an iSCSI Software Adapter and Created an iSCSI Multipath network for your iSCSI storage.



*******************************************************************************************************************************************
Thank you for reading my article, please leave valuable feedback. If you liked my VMware article and would like to see more VMware Articles from me, please click the Yes button near the: Was this article helpful? at the Top of this article to the right of the Article title. Thank You.
*******************************************************************************************************************************************
    Asked On
    2012-01-14 at 13:18:52ID9209
    Tags

    VMware vSphere Hypervisor

    ,

    ESXi 4.1

    ,

    iSCSI

    ,

    iSCSI Software Adaptor

    Topic

    VMware

    Views
    1863

    Comments

    Add your Comment

    Please Sign up or Log in to comment on this article.

    Join Experts Exchange Today

    Gain Access to all our Tech Resources

    Get personalized answers

    Ask unlimited questions

    Access Proven Solutions

    Search 3.2 million solutions

    Read In-Depth How-To Guides

    1000+ articles, demos, & tips

    Watch Step by Step Tutorials

    Learn direct from top tech pros

    And Much More!

    Your complete tech resource

    See Plans and Pricing

    30-day free trial. Register in 60 seconds.

    Loading Advertisement...

    Top VMware Experts

    1. hanccocka

      2,402,899

      Genius

      20,820 points yesterday

      Profile
      Rank: Genius
    2. coolsport00

      259,512

      Guru

      0 points yesterday

      Profile
      Rank: Genius
    3. paulsolov

      48,915

      400 points yesterday

      Profile
      Rank: Genius
    4. BestWay

      41,955

      600 points yesterday

      Profile
      Rank: Sage
    5. danm66

      39,761

      0 points yesterday

      Profile
      Rank: Wizard
    6. IanTh

      32,340

      0 points yesterday

      Profile
      Rank: Genius
    7. andyalder

      32,308

      0 points yesterday

      Profile
      Rank: Genius
    8. thinkpads_user

      24,520

      0 points yesterday

      Profile
      Rank: Genius
    9. kevinhsieh

      23,604

      0 points yesterday

      Profile
      Rank: Genius
    10. millardjk

      18,282

      0 points yesterday

      Profile
      Rank: Master
    11. rindi

      17,077

      0 points yesterday

      Profile
      Rank: Savant
    12. CarlWebster

      16,686

      0 points yesterday

      Profile
      Rank: Genius
    13. RickEpnet

      14,468

      0 points yesterday

      Profile
      Rank: Guru
    14. EvertG

      14,300

      0 points yesterday

      Profile
    15. cwstad2

      13,984

      0 points yesterday

      Profile
      Rank: Guru
    16. cdfs

      13,168

      0 points yesterday

      Profile
      Rank: Master
    17. Neilsr

      12,652

      0 points yesterday

      Profile
      Rank: Genius
    18. npsingh123

      11,452

      0 points yesterday

      Profile
      Rank: Master
    19. dkotte

      11,400

      0 points yesterday

      Profile
      Rank: Guru
    20. dlethe

      11,100

      0 points yesterday

      Profile
      Rank: Genius
    21. arnold

      10,782

      0 points yesterday

      Profile
      Rank: Genius
    22. demazter

      10,656

      0 points yesterday

      Profile
      Rank: Genius
    23. Anuroopsundd

      9,724

      0 points yesterday

      Profile
      Rank: Sage
    24. S00007359

      9,676

      0 points yesterday

      Profile
      Rank: Guru
    25. LesterClayton

      9,100

      0 points yesterday

      Profile
      Rank: Guru

    Hall Of Fame