Search the VMware Knowledge Base (KB)
View by Article ID

iSCSI Port Binding fails with the error: Add NIC failed in IMA (1009450)

  • 31 Ratings


  • Trying to bind a VMkernel port to the software iSCSI initiator using this command fails:

    esxcli swiscsi nic add -n vmk0 -d vmhba32

  • You see the errors:

    Add NIC failed in IMA.


    Failed to add NIC

Note: Access the VMkernel interface by running the command # esxcfg-vmknic -l.


The software iSCSI initiator (for example, vmhba32) typically has 2 VMkernel ports bound to it (for example, vmk0 & vmk1). These VMkernel ports may in turn be associated with uplinks (for example,  vmnic0 and vmnic1) on a vswitch.
If the switch has 2 uplinks (typical example), then the first vmkernel port (in this example, vmk0) must have one uplink active (in this example, vmnic0) and the other uplink unused (in this example, vmnic1). The second VMkernel port (in this example, vmk1) must have one uplink active (in this example, vmnic1) and the other uplink unused (in this example, vmnic0).
If the second NIC is not placed in unused mode, the operation fails.
To resolve this issue, ensure that the other NIC is in unused mode when doing iSCSI port binding. 
To set the network card in the unused mode:
  1. Connect to vCenter Server using the vSphere Client.
  2. Click the ESX host in the vCenter Server inventory.
  3. Click the Configuration tab.
  4. Click the Networking option under Hardware.
  5. Locate the virtual switch that you use for the iSCSI port binding.
  6. Click Properties. The Properties window for the vSwitch appears.
  7. Click vSwitch and click Edit.
  8. In the window that opens, click the NIC Teaming tab and move the appropriate adapter to Unused Adapters.
  9. Click OK and CLOSE to close the vSwitch Properties windows. 
Note: This issue may also occur if you provide the wrong parameter to the flag -n in the command esxcli swiscsi nic add -n vmk0 -d vmhba32. Ensure all parameters are correct.



Update History

03/22/2011 - Added steps to set the network card in the unused mode 11/06/2012 - Added link to article 2038869

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 31 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 31 Ratings