Skip to main content
Delphix

Resolving iSCSI LUN Discovery Failures on Windows Machines (KBA1613)

 

KBA

KBA#1613

Issue 

In some circumstances, SQL Server VDB Provisioning, Refresh or Enable operations may fail with one of the following error and action statements: 

Description: For the virtual database "DATABASE_NAME", failed to mount iSCSI LUNs from the Delphix Engine on target host "HOSTNAME".

or, in the case of enable,

Description: Failed to discover and mount LUNs from the Delphix Engine through the iSCSI initiator on target host "HOSTNAME"

 

Action: Make sure that the iSCSI initiator is running and that the user "USERNAME" has privileges to mount LUNs on the host.

or 

Action: Make sure that the iSCSI initiator is running and that the user "USERNAME" has privileges to perform disk management on the host.

Applicable Delphix Versions 

Click here to view the versions of the Delphix engine to which this article applies
Major Release All Sub Releases
6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.2.1, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.6.1, 6.0.7.0

5.3

5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0, 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0

5.2

5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1

5.1

5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0

5.0

5.0.1.0, 5.0.1.1, 5.0.2.0, 5.0.2.1, 5.0.2.2, 5.0.2.3, 5.0.3.0, 5.0.3.1, 5.0.4.0, 5.0.4.1, 5.0.5.0, 5.0.5.1, 5.0.5.2, 5.0.5.3, 5.0.5.4

Troubleshooting Error "failed to mount iSCSI LUNs"

As part of linking and provisioning, the Delphix Engine presents disks LUNs to Windows Staging and Target hosts via iSCSI. The Delphix Engine then runs scripts on these hosts (using the native diskpart utility), to find the disks and mount them on the Windows machine.

The discovery process scans all configured SCSI devices for new disks. This operation typically completes in a few seconds, but may fail if some SCSI devices connected to the Windows host do not respond.

Check to make sure the iSCSI port 3260 is not blocked.  This is the iSCSI port listener on the Delphix engine and might be blocked on the Windows host firewall.

The Windows iSCSI Initiator applet (iscsicpl.exe) may help you identify iSCSI targets that are contributing to the "failed to mount iSCSI LUNs" error.

The Reconnecting... state shows that the Windows host is currently unable to reach some of its configured iSCSI targets, slowing down discovery:

clipboard_ef29805b0aa12c1e90c9ca17b1a46cbb1.png

Potential causes for the "Reconnecting..." state include:

  • The iSCSI Target is currently rebooting
  • The iSCSI Target is offline for maintenance
  • The iSCSI Target has changed IP addresses or been decommissioned and is no longer accessible

ResolutionEdit section

If some iSCSI Targets are stuck in a "Reconnecting..." state because they are no longer present, they should be removed from the list of iSCSI Target Portals on the affected Windows host.

  1. From the iSCSI Initiator, select the target in "Reconnecting" state and open its Properties:
    clipboard_e37ff757f4a3f89f24f9df67a0456109b.png
     
  2. From the Properties tab, identify the Portal's IP address or hostname:
    clipboard_eb405194c6781f6fcd2f7b7ea49b3c41e.png
     
  3. Use the Disconnect button to stop the iSCSI connection attempt:
    clipboard_e5d2406a083dc46317c4ca8f2354b0974.png
     
  4. From the Discovery tab, select the portal identified in Step 2, then use the Remove button to prevent future attempts to connect to that iSCSI Target:
    clipboard_e610b24cbd71e1de52670c7350a12fab0.png
     

If an iSCSI Target is required for the operation of a VDB, the Delphix Engine will automatically re-create any necessary configuration on the next VDB type operation involving the iSCSI mounting process (provision, refresh, rewind, enable, etc).