Summary of the content on the page No. 1
User’s Guide
IOCTL to Open-iSCSI Interface
QLogic 4000 Series iSCSI Adapters and 8200 Series
Converged Network Adapters
IS0054604-00 A
Summary of the content on the page No. 2
User’s Guide—IOCTL to Open-iSCSI Interface QLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this d
Summary of the content on the page No. 3
Table of Contents Preface What is in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Technical Support. . . . . . . . . . .
Summary of the content on the page No. 4
User’s Guide—IOCTL to Open-iSCSI Interface QLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters Boot Target Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Default Behavior on RHEL 6.2 . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Default Behavior on SLES 11 SP2 . . . . . . . . . . . . . . . . . . . . . . . 3-3 Persistence through Flash and Open-iSCSI Database . . . . . . . . . . . . 3-3 Managing QLogic iSCSI Adapters Us
Summary of the content on the page No. 5
User’s Guide—IOCTL to Open-iSCSI Interface QLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters 1-5 Open-iSCSI Target Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10 1-6 IOCTL Session Recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11 1-7 Open-iSCSI Session Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 1-8 IOCTL State Tra
Summary of the content on the page No. 6
User’s Guide—IOCTL to Open-iSCSI Interface QLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters 2-41 Selecting the Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30 2-42 Installation in Progress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-31 2-43 Installation Completed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32 L
Summary of the content on the page No. 7
Preface ® ® ® ® Starting with Red Hat Enterprise Linux (RHEL™) 6.2 and Novell SUSE Linux ® Enterprise Server (SLES ) 11 SP2, the QLogic qla4xxx driver (iSCSI driver for Linux) supports the Open-iSCSI tool iscsiadm. As a result, iscsiadm can now be used to perform management functions (configuring network settings, managing iSCSI targets, and so on) on QLogic 4000 Series 1GbE iSCSI Adapters and 8200 Series 10GbE Converged Network Adapters. What is in This Guide This document describes the d
Summary of the content on the page No. 8
Preface Related Materials Related Materials For additional information, refer to the following: Technical Note, 2.10. Kernel http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/6.2_T echnical_Notes/kernel_issues.html Release Notes for SUSE Linux Enterprise Server 11 Service Pack 2 http://www.novell.com/linux/releasenotes/i386/SUSE-SLES/11-SP2/ Linux Open-iSCSI README http://www.open-iscsi.org/docs/README Documentation Conventions This guide uses the following documentati
Summary of the content on the page No. 9
Preface Technical Support Text in italics indicates terms, emphasis, variables, or document titles: For a complete listing of license agreements, refer to the QLogic Software End User License Agreement. What are shortcut keys? To enter the date type mm/dd/yyyy (where mm is the month, dd is the day, and yyyy is the year). Topic titles between quotation marks identify related topics either within this manual or in the online help, which is also referred to as the help system througho
Summary of the content on the page No. 10
Preface Technical Support Training QLogic Global Training maintains a Web site at www.qlogictraining.com offering online and instructor-led training for all QLogic products. In addition, sales and technical professionals may obtain Associate and Specialist-level certifications to qualify for additional benefits from QLogic. Contact Information QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays. For customer
Summary of the content on the page No. 11
1 Legacy vs. Open-iSCSI This section describes the major differences between the legacy driver which has an IOCTL-based interface for user space application communications, and the Open-iSCSI model. This section includes the following topics: “Summary of Major Differences” on page 1-2 “Functional Flows” on page 1-7 “State Transition Diagrams” on page 1-13 IS0054604-00 A 1-1
Summary of the content on the page No. 12
1–Legacy vs. Open-iSCSI Summary of Major Differences Summary of Major Differences Table 1-1 summarizes the major differences between the legacy IOCTL-based and Open-iSCSI models. Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models Serial Feature IOCTL-based Driver Open-iSCSI-based Driver Remarks No. 1 Firmware Firmware is configured in Firmware is configured in NON Operational AUTO CONNECT AUTO CONNECT MODE. In Mode MODE. In this mode: this mode: The firmware reads The driv
Summary of the content on the page No. 13
1–Legacy vs. Open-iSCSI Summary of Major Differences Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models (Continued) Serial Feature IOCTL-based Driver Open-iSCSI-based Driver Remarks No. 3 Boot Target During driver load, the Login to boot targets is trig- Note: For more firmware performs auto gered by the driver, or the user details on adapter discovery and login to the space is dependent on the mode and the boot targets based on the ql4xdisablesysfsboot ql4xdisables-y target i
Summary of the content on the page No. 14
1–Legacy vs. Open-iSCSI Summary of Major Differences Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models (Continued) Serial Feature IOCTL-based Driver Open-iSCSI-based Driver Remarks No. a 6 How to view Use the following command: Qlogic application sessions iscsiadm -m session logged in 7 Target scan- Login and target scanning Login and target scanning is ning is done in kernel space as done by user space as follows: follows: 1. When the driver receives 1. When the driver an AE
Summary of the content on the page No. 15
1–Legacy vs. Open-iSCSI Summary of Major Differences Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models (Continued) Serial Feature IOCTL-based Driver Open-iSCSI-based Driver Remarks No. 9 Dynamic The driver handles the No explicit support to dynami- map- following check condi- cally discover newly added ping/unmap- tion/sense data: LUNs on the back-end stor- ping of LUNs age. Requires manual rescan- UNIT_ATTENTION added to the ning using iscsiadm ASC/ASCQ : 0x3F/0x0E back-end
Summary of the content on the page No. 16
1–Legacy vs. Open-iSCSI Summary of Major Differences Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models (Continued) Serial Feature IOCTL-based Driver Open-iSCSI-based Driver Remarks No. 12 Flash DDBs Not applicable The Open-iSCSI driver will Note: iscsiadm with support existing Flash DDB is not capable of Open-iSCSI entries in the adapter. managing the model driver iscsiadm has no control Flash target over these sessions. Session entries. management of Flash DDB Before migra
Summary of the content on the page No. 17
1–Legacy vs. Open-iSCSI Functional Flows Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models (Continued) Serial Feature IOCTL-based Driver Open-iSCSI-based Driver Remarks No. 13 CHAP CHAP settings are With CHAP support in Note: Before you applied using the QLogic iscsiadm, CHAP entries can migrate, delete all a now be added, deleted, and CHAP information application . listed from the user space. from Flash using the QLogic applica- a tion , and then update the same CHAP info
Summary of the content on the page No. 18
1–Legacy vs. Open-iSCSI Functional Flows Discovery Figures 1-1 through 1-3 provide functional flow diagrams of the discovery process for IOCTL and Open-iSCSI. Figure 1-1. Noninteractive Discovery in IOCTL Mode (Legacy) Figure 1-2. Interactive Discovery in IOCTL Mode (Legacy) 1-8 IS0054604-00 A
Summary of the content on the page No. 19
1–Legacy vs. Open-iSCSI Functional Flows Figure 1-3. Open-iSCSI Discovery IS0054604-00 A 1-9
Summary of the content on the page No. 20
1–Legacy vs. Open-iSCSI Functional Flows Target Login Figures 1-4 through 1-5 provide functional flow diagrams of the target login process for IOCTL and Open-iSCSI. Figure 1-4. IOCTL iSCSI Target Login Figure 1-5. Open-iSCSI Target Login 1-10 IS0054604-00 A
