Unable to edit iSCSI Software Adapter properties in vSphere ESXi

In a vSphere ESXi host, you may encounter some issues when trying to access the iSCSI Software Adapter properties, as doing so will prompt a “A general system error occured:” error, as shown below.

Error:A general system error occurred:

Error Stack

Call “IscsiManager.QueryCandidateNics” for object “iscsiManager” on ESXi “X.X.X.X” failed.

 

Sofware iSCSI-A general system error occured

Also, you may not be able to add any network mapping to the iSCSI Adapter from vSphere Web Client, as the option would be disabled.

Having googled the issue, not many efficient solutions were suggested for this problem, except for the one posted here, which resolved it straight away. Here are the steps to follow, depending whether you have an already used Software iSCSI adapter or not.

The resolution of this issue will be as follow:

1. Disable the iSCSI software adapter. If the iSCSI adapter is already used in production, copy the IQN and and paste it to notepad.

Sofware iSCSI-A general system error occured

Sofware iSCSI-A general system error occured

 

2. SSH to the host, go to /etc/vmware/vmkiscsid/, and delete the content of this folder. To do so, run the following command

#Move to vmkiscsid folder

cd /etc/vmware/vmkiscsid/

#Check the existing content

ls

#Delete the vmkiscsid folder content

rm -rf *

#Check that vmkiscsid folder content is deleted

ls

Sofware iSCSI-A general system error occured

3. Once done, put the in Maintenance Mode, and reboot it.

Sofware iSCSI-A general system error occured

4. Create a new Software iSCSI Adapter, and write over the IQN with the old one copied earlier. The IQN needs to be copied only if the iSCSI Adapter was previously used, as this will keep the iSCSI metadata informationSofware iSCSI-A general system error occured Sofware iSCSI-A general system error occured

At this stage, you should be able to edit properties of the iSCSI Software Adapter without any issue. You will be able to add iSCSI port bindings and targets.

Software iSCSI-A general system error occured

Find this post interesting. Share it!

Leave a Comment

Your email address will not be published. Required fields are marked *