Sun Microsystems, Inc.  Sun System Handbook - ISO 4.1 October 2012 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-75-1401425.1
Update Date:2012-05-30
Keywords:

Solution Type  Troubleshooting Sure

Solution  1401425.1 :   Sun Storage 7000 Unified Storage System: iSCSI Troubleshooting - Cause Determination  


Related Items
  • Sun Storage 7410 Unified Storage System
  •  
  • Sun Storage 7310 Unified Storage System
  •  
  • Sun Storage 7720 Unified Storage System
  •  
  • Sun ZFS Storage 7120
  •  
  • Sun ZFS Storage 7320
  •  
  • Sun ZFS Storage 7420
  •  
  • Sun Storage 7110 Unified Storage System
  •  
  • Sun Storage 7210 Unified Storage System
  •  
Related Categories
  • PLA-Support>Sun Systems>DISK>NAS>SN-DK: 7xxx NAS
  •  
  • .Old GCS Categories>Sun Microsystems>Storage - Disk>Unified Storage
  •  




In this Document
Purpose
Troubleshooting Steps
 Performance Problems
 Initiator Host Boot Problems
 Connectivity Problems
 Identifying if ZFSSA Is Presenting the LUN to the initiator host correctly:
 Identifying if ZFSSA Discovery Is Set up Correctly:
 Identifying ZFSSA Authentication Problems:
 iSCSI Network Connectivity Information
References


Applies to:

Sun ZFS Storage 7120 - Version Not Applicable to Not Applicable [Release N/A]
Sun ZFS Storage 7320 - Version Not Applicable to Not Applicable [Release N/A]
Sun ZFS Storage 7420 - Version Not Applicable to Not Applicable [Release N/A]
Sun Storage 7410 Unified Storage System - Version Not Applicable to Not Applicable [Release N/A]
Sun Storage 7310 Unified Storage System - Version Not Applicable to Not Applicable [Release N/A]
7000 Appliance OS (Fishworks)

Purpose

*Purpose
Enter a clear description of what the document is trying to achieve.

This document helps you determine the cause of iSCSI problems on the Oracle ZFS Strorage Appliance (ZFSSA), it will guides you through identifying causes for iSCSI connectivity problems.
It will also point to related documents for performance and boot issues. This document does not cover generic network issues.

To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start a discussion in the My Oracle Support Community - 7000 Series ZFS Appliances

Troubleshooting Steps

iSCSI problems falls into the following categories.

  • Performance Problems
  • initiator Host Boot Problems
  • Connectivity Problems

Performance Problems

Please refer to the respective product documentation for performance issues on the initiator side.  However,  if you  have reason to believe the initiator performance is not the issue and the performance problem is caused by ZFSSA, refer to the following document.

<Document: 1331769.1> Sun Storage 7000 Unified Storage System: How to troubleshoot performance issues.

Initiator Host Boot Problems

If you are experiencing problems booting initiator hosts from an iSCSI LUN on the ZFSSA, and your initiator host is running Oracle Solaris operating system, please refer to respective product documentation.  Currently iSCSI boot is supported only on Solaris 11.

If you are experiencing problems booting initiator hosts from an iSCSI LUN on the ZFSSA but the initiator hosts are running other operating systems, consult with vendor of the operating system first to rule out known problems with the operating system.

If the booting problem seems to be caused by loss of connection to iSCSI LUN, move on to the following section about iSCSI connectivity.

Connectivity Problems

iSCSI connectivity problems will reside in the following areas:

  • ZFSSA is not presenting the LUN to the initiator host
  • Initiator side problems
  • Authentication Problem
  • iSCSI related services or ports are not available

Identifying if ZFSSA Is Presenting the LUN to the initiator host correctly:

Initiator hosts may have difficulties accessing to iSCSI LUNs on ZFSSA when one or more of the following criteria are met.

  • iSCSI service is not running on the ZFSSA correctly.
  • The LUN has not been created yet.
  • The LUN is not assigned to the correct host group or target group, therefore ZFSSA does not present LUN to the initiator IQN.
  • The configured initiator IQN is wrong.

In order to make sure ZFSSA is presenting iSCSI LUN correctly, check if the following criteria are met.Check initiator side IQN is defined correctly.

  • Check what initiator group the initiator IQN belongs to. See documents:

<Document 1395907.1> Sun Storage 7000 Unified Storage System: How to identify the initiator IQN on ZFSSA.

<Document 1395943.1> Sun Storage 7000 Unified Storage System: How to identify the initiator group that IQN belongs to on ZFSSA.

  • Check what target group the ZFSSA target IQN belongs to. See documents:

<Document 1395320.1> Sun Storage 7000 Unified Storage System: How to identify target IQN on ZFSSA.

<Document 1395356.1> Sun Storage 7000 Unified Storage System: How to identify the target group that the target IQN belongs to on the ZFSSA.

  • Check target is listening to the correct interface (IP or IPMP address) and make sure the LUN is correctly assigned.

<Document 1395923.1> Sun Storage 7000 Unified Storage System: How to check LUN properties on ZFSSA.

Identifying if ZFSSA Discovery Is Set up Correctly:

This section is valid ONLY WHEN you are using iSNS as a discovery method of iSCSI devices from the host.
Refer to the following document to verify if iSNS is set up correctly.
<Document 1398633.1> Sun Storage 7000 Unified Storage System: How to check iSNS/RADIUS settings on ZFSSA.
Also, consult with the iSNS server manual to verify the ZFSSA target IQN is correctly registered.

Identifying ZFSSA Authentication Problems:

iSCSI initiators cannot communicate to the iSCSI targets when the initiator and the target do not agree on the authentication method, or authentication is not successful. The following document will help identify what authentication mechanism is used against the iSCSI targets.

There are three authentication methods.

  • None - no authentication, in this case the IQN of the host initiator must be defined manually on the ZFSSA.
  • CHAP (Challenge and Password) - a CHAP secret will need to be set
  • RADIUS - No password or secret needs to be set

None

If no authentication mechanism is used, the initiator IQN must be defined manually.
The following should be left blank.

  • CHAP Name and CHAP secret on initiator
  • CHAP Name and CHAP secret on target

RADIUS

If RADIUS authentication is used, the RADIUS properties must be set correctly in the iSCSI service screen.
Please refer to the following document. Check the IP address or host name of RADIUS server. If the host name is used, make sure it can be resolved to it's IP address correctly.

<Document 1398633.1> Sun Storage 7000 Unified Storage System: How to check iSNS/RADIUS settings on ZFSSA.

CHAP

If CHAP is used check the following:

  • Check that initiator CHAP names and secrets match on both sides.
  • Make sure that the target CHAP name and secret do not match those of any of the initiators.

Refer to the following documents to identify your CHAP names
(You cannot view CHAP secrets thus you need to set them up again if you are unsure.)

<Document 1401469.1> Sun Storage 7000 Unified Storage System: How to identify target CHAP name on ZFSSA .
<Document 1401493.1> Sun Storage 7000 Unified Storage System: How to identify initiator CHAP name on ZFSSA.
<Document 1181788.1> Sun Storage 7110 Unified Storage System: How to configure unidirectional CHAP for Solaris iSCSI initiator.
<Document 1181843.1> Sun Storage 7110 Unified Storage System: How to configure bidirectional CHAP for Solaris iSCSI initiator.
<Document 1175563.1> Sun Storage 7000 Unified Storage System: How to configure iSCSI CHAP for Windows iSCSI Initiator.

iSCSI MC/S (multiple connection per session) is not supported by ZFS Storage Appliance at this time, therefore only IPMP or Link Aggregation should be used for multiple network path at this time.

iSCSI Network Connectivity Information

The following are iSCSI related services and port numbers. The port number should be open to enable initiators, targets and iSCSI related services to communicate to each other.

  • iSCSI TCP/3260
  • iSNS TCP/3205
  • DNS TCP/53 UDP/53
  • RADIUS TCP/1812, TCP/1813

 

Click here to return to <Document 1398581.1> Sun Storage 7000 Unified Storage System: How to Troubleshoot iSCSI Problems.

References

<NOTE:1395356.1> - Sun Storage 7000 Unified Storage System: How to identify the target group that target IQN belongs on ZFSSA
<NOTE:1395923.1> - Sun Storage 7000 Unified Storage System: How to check LUN properties on ZFSSA
<NOTE:1398633.1> - Sun Storage 7000 Unified Storage System: How to check iSNS/RADIUS settings on ZFSSA
<NOTE:1401469.1> - Sun Storage 7000 Unified Storage System: How to identify target CHAP name on ZFSSA
<NOTE:1331769.1> - Sun Storage 7000 Unified Storage System: How to Troubleshoot Performance Issues
<NOTE:1398581.1> - Sun Storage 7000 Unified Storage System: How to Troubleshoot iSCSI Problems
<NOTE:1175563.1> - Sun Storage 7000 Unified Storage System: How to configure iSCSI CHAP for Windows iSCSI Initiator
<NOTE:1401493.1> - Sun Storage 7000 Unified Storage System: How to identify initiator CHAP name on ZFSSA
<NOTE:1181788.1> - Sun Storage 7110 Unified Storage System: How to configure unidirectional CHAP for Solaris iSCSI initiator
<NOTE:1181843.1> - Sun Storage 7000 Unified Storage System: How to configure bidirectional CHAP for Solaris iSCSI initiator
<NOTE:1395907.1> - Sun Storage 7000 Unified Storage System: How to identify the initiator IQN on ZFSSA
<NOTE:1395943.1> - Sun Storage 7000 Unified Storage System: How to identify the initiator group that IQN belongs to on ZFSSA
<NOTE:1395320.1> - Sun Storage 7000 Unified Storage System: How to identify target IQN on ZFSSA

Attachments
This solution has no attachment
  Copyright © 2012 Sun Microsystems, Inc.  All rights reserved.
 Feedback