OneCore™ Storage FAQs Revision 1.3 April 8, 2015 P009876-04A Rev. A Connect • Monitor • Manage 2 Copyright © 2013–2015 Emulex. All rights reserved worldwide. No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex. Information furnished by Emulex is believed to be accurate and reliable. However, no responsibility is assumed by Emulex for its use; or for any infringements of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under any patent, copyright, trade secret or related rights of Emulex. Emulex, the Emulex logo, Emulex BladeEngine, Emulex InSpeed, Emulex LightPulse, Emulex OneCommand, Emulex OneConnect, and Emulex SLI are registered trademarks, and Emulex Advanced-8, Emulex Connect, Emulex CrossLink, Emulex Engine, Emulex Edge, Emulex ExpressLane, Emulex GreenState, Emulex OneCore, Emulex Pilot, Emulex SURF, Emulex Universal Multi-Channel, Emulex vEngine, Emulex Virtual Fabric, Emulex Virtual Network Exceleration, Emulex vPath, and Emulex vScale, are trademarks, of Emulex. All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations. Emulex provides this documentation “as is” without any warranty of any kind, either expressed or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. Emulex may make improvements and changes to the product described in this manual at any time and without any notice. Emulex assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties that may result. Periodic changes are made to information contained herein; although these changes will be incorporated into new editions of this documentation, Emulex disclaims any undertaking to give notice of such changes. Emulex, 3333 Susan Street Costa Mesa, CA 92626 OneCore Storage FAQs P009876-04A Rev. A Revision 1.3 April 8, 2015 Table of Contents 3 Table of Contents 1 Overview ...............................................................................7 1.1 Purpose .................................................................................7 1.2 Emulex Documentation ..............................................................7 1.3 Acronyms ...............................................................................8 2 General OneCore Storage SDK Questions ...................................... 10 2.1 Information to Provide for Support Help....................................... 10 2.1.1 What is the minimum information that should be provided when requesting support help? .....................................................10 2.1.2 What other helpful information should be provided when requesting support? ..................................................................10 2.2 Supported Products................................................................. 11 2.2.1 Which SLI-4 products are supported? .......................................11 2.2.2 Are SLI-3 products supported? ...............................................11 2.3 Driver Compatibility and Usage .................................................. 12 2.3.1 Can I connect my back-end (SCSI initiator/target) to a OneCore Storage driver in a transport-agnostic way?...........................12 2.3.2 Are the drivers subject to GPL? .............................................12 2.3.3 Do the OneCore Storage drivers support Linux TGT/STGT or IET?......................................................................................12 2.3.4 Why do you provide user space versions of your drivers? ...............12 3 SLI-4 General Questions ........................................................... 13 3.1 Queue-Specific Questions ......................................................... 13 3.1.1 Is having a different queue ID before and after SLI Port initialization an error? ...............................................................13 3.1.2 How can the SLI Host prevent a CQ full condition?.......................13 3.1.3 Why would a full queue appear as “empty”?..............................13 3.2 Miscellaneous ........................................................................ 13 3.2.1 How do you determine the size of the VPD? ..............................13 3.2.2 How can you disable interrupts? ............................................14 3.2.3 How can the SFP VPD be retrieved faster when using the DUMP Type 3 Command?.............................................................14 4 Protocol-Specific Questions....................................................... 15 4.1 FC-Specific Questions .............................................................. 15 4.1.1 Do SGL pages need to be posted prior to an FLOGI? .....................15 OneCore Storage FAQs P009876-04A Rev. A Revision 1.3 April 8, 2015 Table of Contents 4 4.1.2 How do I prevent the inbox lpfc driver from loading on a Linux system reboot?.................................................................15 4.1.2.1 lpfc.ko in /lib/modules/`uname -r` ...................................... 15 4.1.2.2 lpfc.ko Inside Boot RAM File System ...................................... 15 4.1.2.2.1 Example to Prevent lpfc.ko from Loading................... 15 4.1.2.2.2 Bash Script to Prevent lpfc.ko from Loading ............... 16 4.1.3 How can the driver determine if the FC topology is point-to-point or fabric?.............................................................16 4.1.4 FC/FCoE Status Code Questions .............................................16 4.1.4.1 When retrying a request, does the SLI Host have to issue an ABORT_WQE first? ................................................................. 17 4.1.4.2 When does the SLI Port post RQ-related CQEs to the SLI Host? ..................................................................................... 17 4.1.4.3 FC/FCOE Completion Status Codes Summary Table - Additional Details...................................................................... 17 4.1.4.4 LOCAL_REJECT Reason Code Table - Additional Details ............... 18 4.1.5 What is the Meaning of a CQE Status Code=0x0A?........................19 5 Controller-Specific Questions .................................................... 20 5.1 XE201-Specific Questions ......................................................... 20 5.1.1 Feature Updates ...............................................................20 5.1.2 Initialization and Configuration .............................................20 5.1.2.1 What is the initialization sequence for properly configuring the XE201 (or an SLI-4 FC device)?.................................................. 20 5.1.2.2 Why are XE201 PCI BARs assigned offsets 0x10 and 0x20 in PCI configuration space for IF_TYPE=2?......................................... 20 5.1.2.3 What are the XE201 default settings for the Bus Master Enable and Enable No Snoop bits in the PCI registers? .......................... 21 5.1.3 Normal I/O Path ...............................................................21 5.1.3.1 How many XRIs does the XE201 support? ................................. 21 5.1.3.2 What is the correlation between BB_Credit and RQ unsolicited buffer count for XE201? ................................................ 21 5.1.4 Error Handling..................................................................22 5.1.4.1 How does the SLI Host detect and recover from an SLI Port error condition?.............................................................. 22 5.1.4.2 After the SLI Port sets ERR=1, are all other SLIPORT_STATUS register bits valid?................................................ 23 5.1.4.3 How do you perform a graceful shutdown prior to an SLI Port reset? .............................................................................. 23 5.1.5 Adapter Management .........................................................24 5.1.5.1 What is the expected minimum or maximum size of an XE201-generated dump file? ......................................................... 24 OneCore Storage FAQs P009876-04A Rev. A Revision 1.3 April 8, 2015 Table of Contents 5 5.1.5.2 Before the XE201 captures a new firmware dump, does an existing dump have to be deleted? ................................................. 24 5.1.5.3 How do you retrieve a firmware dump with the XE201? ............... 24 5.1.5.4 After forcing a dump (DD=1 and FRST=1), is it necessary for the host driver to reset the function via SLI? ................................. 25 5.1.5.5 What is the size of a diagnostic dump image in the COMMON_READ_OBJECT Response Format? ....................................... 25 5.1.5.6 When downloading a .grp firmware file using COMMON_WRITE_OBJECT, what is Object_Name? ............................... 25 5.1.5.7 How do you update firmware using the COMMON_WRITE_OBJECT command for XE201? .................................. 26 5.1.5.8 While waiting for OCS_HAL_DUMP_READY, is any driver code running prior to the remainder of ocs_gen_dump()?............................. 26 5.1.5.9 What is the list of valid Test IDs for XE201 (FCOE_RUN_LINK_DIAG_TEST)? ...................................................... 27 5.1.5.10 For FC SAN, what tool can monitor the HBA bandwidth utilization status?...................................................................... 27 5.1.5.11 PCIe-Specific Information ................................................. 28 5.1.5.11.1