Page 2 - Document Revision History
ii IS0054604-00 A User’s Guide—IOCTL to Open-iSCSI InterfaceQLogic 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 infrin...
Page 3 - Table of Contents; Preface; Open-iSCSI User’s Guide
IS0054604-00 A iii Table of Contents Preface What is in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Related Materials . . . . . . . . ....
Page 4 - Known Issues; Figure
iv IS0054604-00 A User’s Guide—IOCTL to Open-iSCSI InterfaceQLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters Boot Target Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Default Behavior on RHEL 6.2 . . . . . . . . . . . . . . . . ...
Page 6 - List of Tables; Table
vi IS0054604-00 A User’s Guide—IOCTL to Open-iSCSI InterfaceQLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters 2-41 Selecting the Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30 2-42 Installation in Progress . . . . ....
Page 7 - What is in This Guide; Intended Audience
IS0054604-00 A vii 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 funct...
Page 8 - Related Materials; Documentation Conventions
PrefaceRelated Materials viii IS0054604-00 A 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_Technical_Notes/kernel_issues.html Release Notes for SUSE Linux Enterprise Server ...
Page 9 - Technical Support; Downloading Firmware and Documentation; Guided Search
Preface Technical Support IS0054604-00 A ix 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 i...
Page 10 - Training; Support Headquarters
PrefaceTechnical Support x IS0054604-00 A 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 qua...
Page 12 - Summary of Major Differences; Table 1-1. Differences Between IOCTL and Open-iSCSI Driver Models; Serial
1–Legacy vs. Open-iSCSISummary of Major Differences 1-2 IS0054604-00 A 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 No. Feature IOCTL-based Driver...
Page 17 - Functional Flows
1–Legacy vs. Open-iSCSI Functional Flows IS0054604-00 A 1-7 Functional Flows This section provides functional flow diagrams for discovery, target login, and session recovery. 13 CHAP CHAP settings are applied using the QLogic application a . With CHAP support in iscsiadm , CHAP entries can now be ad...
Page 18 - Discovery
1–Legacy vs. Open-iSCSIFunctional Flows 1-8 IS0054604-00 A 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)
Page 20 - Target Login
1–Legacy vs. Open-iSCSIFunctional Flows 1-10 IS0054604-00 A 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
Page 21 - Session Recovery
1–Legacy vs. Open-iSCSI Functional Flows IS0054604-00 A 1-11 Session Recovery Figures 1-6 through 1-7 provide functional flow diagrams of the session recovery process for IOCTL and Open-iSCSI. Figure 1-6. IOCTL Session Recovery
Page 23 - State Transition Diagrams; Figure 1-8. IOCTL State Transition Diagram
1–Legacy vs. Open-iSCSI State Transition Diagrams IS0054604-00 A 1-13 State Transition Diagrams Figures 1-8 through 1-9 provide state transition diagrams for IOCTL and Open-iSCSI. These diagrams illustrate the management of the session/target life cycle. Figure 1-8. IOCTL State Transition Diagram
Page 25 - Boot from SAN
IS0054604-00 A 2-1 2 Boot from SAN This section provides information on configuring Boot from SAN (BFS) when migrating to the Open-iSCSI model. This section includes the following topics: “New Parameter: ql4disablesysfsboot” on page 2-2 “Boot from SAN Configuration Matrix” on page 2-2 “Configu...
Page 26 - NOTE
2–Boot from SANNew Parameter: ql4disablesysfsboot 2-2 IS0054604-00 A New Parameter: ql4disablesysfsboot The ql4disablesysfsboot parameter is a new driver module parameter for the Open-iSCSI based driver model (it is not supported by the ioctl based driver). This parameter controls the behavior of bo...
Page 27 - Table 2-1. Boot from SAN Configuration Matrix
2–Boot from SAN Boot from SAN Configuration Matrix IS0054604-00 A 2-3 Table 2-1. Boot from SAN Configuration Matrix ql4xdisablesysfsboot = 0 ql4xdisablesysfsboot = 1 Boot Target as sendtarget (ST) Boot Target as Normal target (NT) Boot Target as sendtarget (ST) Boot Target as Normal target (NT) Expo...
Page 28 - Configuring Boot from SAN; Boot from SAN Installation on SLES 11 SP2 and RHEL 6.2
2–Boot from SANConfiguring Boot from SAN 2-4 IS0054604-00 A Configuring Boot from SAN Boot from SAN Installation on SLES 11 SP2 and RHEL 6.2 To configure the adapter for BFS on SLES 11 SP2 or RHEL 6.2, follow these steps: 1. While the system is booting up, press CTRL+Q to enter Fast!UTIL on the iSCS...
Page 29 - Figure 2-2. Selecting the Port to Be Configured; Configuration Settings
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-5 2. Once in, select the port to be configured, as shown in Figure 2-2 . Figure 2-2. Selecting the Port to Be Configured 3. Select Configuration Settings , as shown in Figure 2-3 . Figure 2-3. Fast!UTIL Options Menu—Selecting Configuration S...
Page 30 - Host Adapter Settings; Figure 2-4. Selecting the Host Adapter Settings Option; Figure 2-5. Selecting the Initiator IP Settings
2–Boot from SANConfiguring Boot from SAN 2-6 IS0054604-00 A 4. Select Host Adapter Settings , as shown in Figure 2-4 . Figure 2-4. Selecting the Host Adapter Settings Option 5. Select the Initiator IP Settings field, as shown in Figure 2-5 . Figure 2-5. Selecting the Initiator IP Settings
Page 31 - Figure 2-6. Providing the Initiator IP Address
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-7 6. Provide the initiator IP address, as shown in Figure 2-6 . Figure 2-6. Providing the Initiator IP Address 7. Press ESC repeatedly until the screen shown in Figure 2-7 appears. Then, select the iSCSI Boot Settings option. Figure 2-7. Con...
Page 32 - Figure 2-8. Selecting Primary Boot Device Settings; Figure 2-9. Providing Target IP Address for Primary Boot Device
2–Boot from SANConfiguring Boot from SAN 2-8 IS0054604-00 A 8. Select Primary Boot Device Settings, as shown in Figure 2-8 . Figure 2-8. Selecting Primary Boot Device Settings 9. Provide the target IP address, as shown in Figure 2-9 . Figure 2-9. Providing Target IP Address for Primary Boot Device
Page 33 - Figure 2-10. Selecting Alternate Boot Device Settings; Figure 2-11. Providing Target IP Address for Alternate Boot Device
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-9 10. Select Alternate Boot Device Settings, as shown in Figure 2-10 . Figure 2-10. Selecting Alternate Boot Device Settings 11. Provide the target IP address, as shown in Figure 2-11 . Figure 2-11. Providing Target IP Address for Alternate ...
Page 34 - Reinit Adapter; Primary
2–Boot from SANConfiguring Boot from SAN 2-10 IS0054604-00 A 12. Press ESC until the menu in Figure 2-12 appears. Select Reinit Adapter to save all IP settings. Figure 2-12. Fast!UTIL Options 13. In iSCSI Boot Settings, select Primary (LUN), as shown in Figure 2-13 . Figure 2-13. Selecting the Prima...
Page 35 - Figure 2-15. Editing Alternate Boot Device Settings
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-11 14. A list of the port’s devices is displayed, as shown in Figure 2-14 . Select the device to be used as the boot device and press ENTER. Figure 2-14. List of Devices on the Port 15. Repeat steps 13 – 14 to edit the alternate boot device ...
Page 36 - Manual; Figure 2-16. Setting the Boot Mode to Manual
2–Boot from SANConfiguring Boot from SAN 2-12 IS0054604-00 A 16. Change the adapter’s boot mode to Manual , as Figure 2-16 shows. Figure 2-16. Setting the Boot Mode to Manual 17. Save the settings for the port.18. Repeat steps 2 – 14 , but select the second port, and configure the boot targets on th...
Page 37 - Boot from SAN Installation on SLES 11 SP2; withiscsi
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-13 Boot from SAN Installation on SLES 11 SP2 To configure the adapter for BFS on SLES 11 SP2, follow these steps: 1. Boot from the SLES 11 SP2 DVD, as shown in Figure 2-17 . Figure 2-17. Entering the Boot BIOS 2. Provide the withiscsi=1 boot...
Page 41 - Figure 2-25. Selecting the Server Base Scenario
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-17 Figure 2-25. Selecting the Server Base Scenario Figure 2-26. Preparing the Hard Disk
Page 43 - Configuring Boot from SAN on RHEL 6.2; Figure 2-28. Booting From the Installation Media; Figure 2-29. Choosing to Test Media Disk or Skip Test
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-19 Configuring Boot from SAN on RHEL 6.2 Installing RHEL 6.2 To install RHEL 6.2, follow these steps: 1. Boot from the installation media, as shown in Figure 2-28 . Figure 2-28. Booting From the Installation Media 2. Choose eithe...
Page 44 - Figure 2-30. Selecting Network Interface for Installation
2–Boot from SANConfiguring Boot from SAN on RHEL 6.2 2-20 IS0054604-00 A 3. Select the network interface through which the installation is to be done, as Figure 2-30 shows. Figure 2-30. Selecting Network Interface for Installation 4. Configure the IP address either statically or using, as Figure 2-3...
Page 46 - Figure 2-33. Selecting the Language for the Installation
2–Boot from SANConfiguring Boot from SAN on RHEL 6.2 2-22 IS0054604-00 A 6. Select the language to use during the installation, as shown in Figure 2-33 . Figure 2-33. Selecting the Language for the Installation
Page 48 - Basic Storage Devices; Specialized Storage Devices; Figure 2-35. Selecting Storage Device Type
2–Boot from SANConfiguring Boot from SAN on RHEL 6.2 2-24 IS0054604-00 A 8. Select one the two options shown in Figure 2-35 : Basic Storage Devices or Specialized Storage Devices . You may select either option since the LUN has been added in the adapter’s BIOS. Figure 2-35. Selecting Storage Device ...
Page 52 - Figure 2-39. Entering the Root Credentials
2–Boot from SANConfiguring Boot from SAN on RHEL 6.2 2-28 IS0054604-00 A 12. Enter the root credentials that you want to set for the system, as shown in Figure 2-39 . Figure 2-39. Entering the Root Credentials
Page 53 - Figure 2-40. Selecting the Partition Layout Type
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-29 13. Select the type of partition layout you want, as shown in Figure 2-40 . Figure 2-40. Selecting the Partition Layout Type
Page 54 - Figure 2-41. Selecting the Installation Type
2–Boot from SANConfiguring Boot from SAN on RHEL 6.2 2-30 IS0054604-00 A 14. Select the type of installation, as shown in Figure 2-41 . Figure 2-41. Selecting the Installation Type
Page 57 - ql4xdisablesysfsboot Settings and Adapter Boot; Table 2-2. Configurations and Tools for Checking iSCSI Sessions; ql4xdisable
2–Boot from SAN ql4xdisablesysfsboot Settings and Adapter Boot Mode IS0054604-00 A 2-33 ql4xdisablesysfsboot Settings and Adapter Boot Mode This section demonstrates the effect of the ql4xdisablesysfsboot parameter under different adapter boot modes. # iscsiadm -m iface -I qla4xxx.00:c0:dd:07:59:f2....
Page 60 - Open-iSCSI Supported Features; Boot Target Login; Default Behavior on RHEL 6.2
3–Open-iSCSI User’s GuideOpen-iSCSI Supported Features 3-2 IS0054604-00 A Open-iSCSI Supported Features Open-iSCSI support has been added to the QLogic iSCSI driver in Red Hat Enterprise Linux 6.2 and SUSE Linux Enterprise Server 11 Service Pack 2. Open-iSCSI infrastructure supports discovery, login...
Page 61 - Default Behavior on SLES 11 SP2; Persistence through Flash and Open-iSCSI Database
3–Open-iSCSI User’s Guide Open-iSCSI Supported Features IS0054604-00 A 3-3 Default Behavior on SLES 11 SP2 Open-iSCSI is enabled by default on SLES 11 SP2 and login to boot targets is triggered by iscsiadm during installation. The default behavior can be changed by setting the driver parameter ql4xd...
Page 62 - iSCSI Configuration Files and Persistent Databases; Configuring Targets for; Table 3-1. Configuration and Persistent Database Files; File Path and Name
3–Open-iSCSI User’s GuideManaging QLogic iSCSI Adapters Using iscsiadm 3-4 IS0054604-00 A Managing QLogic iSCSI Adapters Using iscsiadm iSCSI Configuration Files and Persistent Databases The Open-iSCSI daemon iscsid can be configured to use the default node configuration and persistent database to a...
Page 64 - iSCSI Interface Configuration; iSCSI Configuration Parameters; Table 3-2. Hardware iSCSI Interface Config File Fields; Needed
3–Open-iSCSI User’s GuideManaging QLogic iSCSI Adapters Using iscsiadm 3-6 IS0054604-00 A iSCSI Interface Configuration iSCSI Configuration Parameters Each iSCSI Host Bus Adapter, NIC, or network interface to which sessions are bound should have its own iSCSI interface config file in /etc/iscsi/ifac...
Page 65 - List All ifaces; Example
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adapters Using iscsiadm IS0054604-00 A 3-7 Example: IPv4 sample config file with static IP address List All ifaces # iscsiadm -m iface Example : # BEGIN RECORD 2.0-872iface.iscsi_ifacename = qla4xxx-3iface.ipaddress = 192.168.1.75iface.hwaddress = 00:0...
Page 66 - Display iface Configuration Details; tcp
3–Open-iSCSI User’s GuideManaging QLogic iSCSI Adapters Using iscsiadm 3-8 IS0054604-00 A Display iface Configuration Details # iscsiadm -m iface -I <iface_name> Example: Create an iface # iscsiadm -m iface -I <iface_name> -o new # iscsiadm -m iface -I qla4xxx.00:c0:dd:0b:13:f1.ipv4.0# B...
Page 67 - Update iface Network Parameters
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adapters Using iscsiadm IS0054604-00 A 3-9 Example: Update iface Network Parameters # iscsiadm -m iface -I <iface_name> -o update -n <rec_name> -v <value> # iscsiadm -m iface -I <iface_name> -o apply # iscsiadm -m iface -I <i...
Page 69 - Unidirectional and Bidirectional CHAP settings
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adapters Using iscsiadm IS0054604-00 A 3-11 Unidirectional and Bidirectional CHAP settings Example: Display changes made to the 192.168.1.84:3260 CHAP settings: NOTE The target should be logged out before updating the network parameters. iscsiadm will ...
Page 70 - Target Discovery; Discover Targets using sendtarget; new; delete; nonpersistent
3–Open-iSCSI User’s GuideManaging QLogic iSCSI Adapters Using iscsiadm 3-12 IS0054604-00 A Target Discovery Discover Targets using sendtarget # iscsiadm -m discovery -t st -p <target_ip:target_port> -I <iface_name> -o new, delete, update, nonpersistent In discovery mode, iscsiadm will us...
Page 71 - Adding a New discoverydb for sendtarget
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adapters Using iscsiadm IS0054604-00 A 3-13 Adding a New discoverydb for sendtarget # iscsiadm -m discoverydb -t st -p 192.168.2.105 -I qla4xxx-3 -o new New discovery record for [192.168.2.105,3260] added. # cat /var/lib/iscsi/send_targets/192.168.2.10...
Page 72 - Remove sendtarget Node; Adding and Deleting Targets; Adding a New Target
3–Open-iSCSI User’s GuideManaging QLogic iSCSI Adapters Using iscsiadm 3-14 IS0054604-00 A Remove sendtarget Node # iscsiadm -m discoverydb -t st -p <target IP> -I <iface> -o delete Example: # iscsiadm -m discoverydb -t st -p 192.168.2.105 -I qla4xxx-3 -o delete Adding and Deleting Targe...
Page 73 - List All Targets; Target Login and Logout; Login to a Target
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adapters Using iscsiadm IS0054604-00 A 3-15 List All Targets # iscsiadm -m node Example: Deleting a Target Node # iscsiadm -m node -T <target name> -p <target portal> -I <iface> -o delete Example: # iscsiadm -m node -T iqn.2001-05.com...
Page 74 - Login to All Targets; Login All Sessions with Specified Parameters; Logout from a Target
3–Open-iSCSI User’s GuideManaging QLogic iSCSI Adapters Using iscsiadm 3-16 IS0054604-00 A Login to All Targets Not specifying the target name, portal, and iface name results in login to all portals on all nodes/targets through each interface specified in the node configuration. # iscsiadm -m node -...
Page 75 - Features Not Supported
3–Open-iSCSI User’s Guide Features Not Supported IS0054604-00 A 3-17 Features Not Supported The features below are not supported in Red Hat Enterprise Linux 6.2. These features will be supported in Red Hat Enterprise Linux 6.3. 1. iSNS 2. Ping Migrating to Open-iSCSI Driver On a system that was succ...
Page 76 - Linux Open-iSCSI README
3–Open-iSCSI User’s GuideLinux Open-iSCSI README 3-18 IS0054604-00 A Linux Open-iSCSI README Go to http://www.open-iscsi.org/docs/README for more detailed information about Linux Open-iSCSI.
Page 77 - QLogic Application Limitations; CHAP Limitations
IS0054604-00 A 4-1 4 Known Issues This section lists currently known issues and provides a brief explanation of each issue. QLogic Application Limitations The RHEL 6.2 and SLES 11 SP2 inbox drivers do not support the following QLogic applications: iscli (SANsurfer iSCSI CLI) qaucli (QConvergeC...