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

Restarting the software iSCSI stack (1004033)

  • 8 Ratings

Purpose

This document discusses problems with the software iSCSI stack that can be resolved by restarting the stack instead of rebooting the entire ESX system.
 
This may be necessary when the detection of storage at boot time fails to acquire the iSCSI targets from the array or when the iSCSI stack stops responding.

Resolution

Caution: This procedure disables all iSCSI traffic that uses the software initiator. Prior to performing these steps:
  • Ensure that there are no virtual machines running on a datastore located on the iSCSI LUNs on the host.
  • Ensure that there are no 3rd party scripts or utilities running on service console which could access iSCSI LUNs on the host. The lsof utility can be used to identify any processes with open file locks to files residing on Datastores on iSCSI LUNs.  For more information on starting and stopping 3rd party services or scripts, please engage the appropriate 3rd party software vendor.  
To restart the software iSCSI stack:
  1. Disable the software iSCSI configuration with the command:

    esxcfg-swiscsi -d
     
  2. Terminate the software iSCSI processes with the command:

    esxcfg-swiscsi -k
     
    In some cases, the iSCSI stack is in an unresponsive state and does not terminate on this command. If this happens, you must find the process ID and issue a terminate command directly to the operating system for this process.
     
    1. Obtain the process ID for the vmkiscsi processes with the command:

      ps ax | grep vmkiscsid
       
    2. Terminate the process with the command:

      kill <process ID>
       
  3. Enable the software iSCSI configuration with the command:

    esxcfg-swiscsi -e 
     
  4. Perform a rescan of the software initiator with the command:

    esxcfg-rescan vmhba40
Note: This procedure only applies if you are using the software iSCSI initiator.
 
Memory resource starvation is one possible reason for the iSCSI stack to become unresponsive. This can occur if agents have been installed on the service console. It is advisable to increase the amount of memory assigned to the service console. For more information, see Increasing the amount of RAM assigned to the ESX Server service console (1003501).

Update History

07/02/2013 - Removed Resolution Path out of Normalization Status.

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.

Feedback

  • 8 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.
  • 8 Ratings
Actions
KB: