Instruction/ maintenance manual of the product IS0054604-00 A Q-Logic
Go to page of 80
IS0054604-00 A User ’ s Guide IOCTL to Open-iSCSI Interface QLogic 4000 Series iSCSI Adapters and 8200 Series Converged Network Adapters.
ii IS0054604-00 A User ’s Gu ide—IOCTL to Open- iSCSI Interf ace QLogic 4000 Series iSCSI Adapters and 820 0 Series Converged Networ k Adapters Information fu rnished in this manual is believe d to be accurate and reliable.
IS0054604-00 A iii T able of Content s Preface What is in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
iv IS0054604-00 A User ’s Gu ide—IOCTL to Open-iSCSI Interfac e QLogic 4000 Series iSCSI Adapters and 820 0 Series Converged Networ k Adapters Boot T arget Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Default Behavior on RHEL 6.
IS0054604-00 A v User ’s Guide—IOCTL to Open-iSCSI Interface QLogic 4000 Series iSCSI Adapter s and 8200 Series Conver ged Network Adap ters 1-5 Open-iSCSI T arget Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi IS0054604-00 A User ’s Gu ide—IOCTL to Open-iSCSI Interfac e QLogic 4000 Series iSCSI Adapters and 820 0 Series Converged Networ k Adapters 2-41 Selecting the Installation T ype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IS0054604-00 A vii Preface S tarting with Red Hat ® Enterprise Linux ® (RHEL™) 6 .2 and Novell ® SUSE ® Linux Enterprise Server (SLES ® ) 1 1 SP2, the QLogic qla4xxx driver (iSCSI driver for Linux) supports the Open-iSCSI tool iscsiadm .
Preface Related Materials viii IS0054604-00 A Related Materials For additional informat ion, refer to the following: T echnical Note, 2.10. Kernel http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_L inux/6/html/6.2_T echnical_Notes/kernel_issues.
Preface T echnical Support IS0054604-00 A ix Te x t i n ital ics indicates terms, emphasis, va riables, or d ocument titles: For a complete listing of license agreement s, refer to the QLogic Software End User License Agreement .
Preface T echnical Support x IS0054604-00 A T raining QLogic Global T raining maintains a W eb site at www .qlogictraining.com offering online and instructor-led trainin g for all QLogic products .
IS0054604-00 A 1-1 1 Legacy vs. Open-iSCSI This section describes the major dif ferenc es between the legacy driver which has an IOCTL-based interface for user space app lication communications, and the Open-iSCSI model.
1–Legacy vs. Open-iSCSI Summary of Major Dif ferences 1-2 IS0054604-00 A Summary of Major Differences T able 1-1 summarizes the major dif ferences between the legacy IOCTL-based and Open-iSCSI models. T able 1-1. Differences Between IOCTL and Open -iSCSI Driver Models Serial No.
1–Legacy vs . Open-iSCSI Summary of Ma jor Dif ferences IS0054604-00 A 1-3 3 Boot T arget During driver load, the firmware performs auto discovery and login to the boot ta rgets based on the target informatio n saved in the Flash, and posts an AEN to inform the driver of the tar gets and th eir login status.
1–Legacy vs. Open-iSCSI Summary of Major Dif ferences 1-4 IS0054604-00 A 6 How to view sessions logged in Qlogic applicat ion a Use the following command: iscsiadm -m session 7 T arget scan- ning Login and t arget scanning is done in kernel sp ace as follows: 1.
1–Legacy vs . Open-iSCSI Summary of Ma jor Dif ferences IS0054604-00 A 1-5 9 Dynamic map- ping/unmap- ping of LUNs added to the back-end stor- age The driver handles the following check condi- tion/.
1–Legacy vs. Open-iSCSI Summary of Major Dif ferences 1-6 IS0054604-00 A 12 Flash DDBs with Open-iSCSI model driver Not applicable The Open -iSCSI driver will support existing Flash DDB entries in the adapter . iscsiadm has no control over these sessions.
1–Legacy vs . Open-iSCSI Functional Flows IS0054604-00 A 1-7 Functional Flows This section provides functional flow diagr ams for discovery , target login, an d session recovery .
1–Legacy vs. Open-iSCSI Functional Flows 1-8 IS0054604-00 A Discovery Figures 1-1 through 1-3 provide functional flow diagra ms of the disco very process for IOCTL and Open-iSCSI. Figure 1-1. Noninteractive Di scovery in IOCTL Mode (Legacy) Figure 1-2.
1–Legacy vs . Open-iSCSI Functional Flows IS0054604-00 A 1-9 Figure 1-3. Open-iSCSI Discovery.
1–Legacy vs. Open-iSCSI Functional Flows 1-10 IS0054604-00 A T arget Login Figures 1-4 through 1-5 provide functional flow diagrams of the targ et login process for IOCTL and Open-iSCSI.
1–Legacy vs . Open-iSCSI Functional Flows IS0054604-00 A 1-1 1 Session Recovery Figures 1-6 through 1-7 provide functional flow diagrams of the session recovery process for IOCTL and Open-iSCSI.
1–Legacy vs. Open-iSCSI Functional Flows 1-12 IS0054604-00 A Figure 1-7. Open-iSCSI Session Recovery.
1–Legacy vs . Open-iSCSI S tate T ransition Diagrams IS0054604-00 A 1-13 S t ate T ransition Diagrams Figures 1-8 through 1-9 provide st ate transition diagrams for IOCTL and Open-iSCSI. These diagrams illustrate the management of the session/t arget life cycle.
1–Legacy vs. Open-iSCSI S tate T ransition Diagrams 1-14 IS0054604-00 A Figure 1-9. Open-iSCSI S tate T ransition Diagram.
IS0054604-00 A 2-1 2 Boot from SAN This section provides information on c onfigurin g Boot from SAN (BFS) when migrating to the Open-iSCSI model. This section includes the following top ics: “Ne.
2–Boot from SAN New Parameter: ql4disablesysfsboot 2-2 IS0054604-00 A New Parameter: ql4disablesysfsboot The ql4disablesysfsboot p arameter is a new driver module parameter for the Open-iSCSI based driver model (it is not supported by the ioctl based driver).
2–Boot from SAN Boot from SAN Configuration Matrix IS0054604-00 A 2-3 T able 2-1. Boot from SAN Configuration Matrix ql4xdisablesysfsboot = 0 ql4xdisablesysfsboot = 1 Boot T arget as send target (ST.
2–Boot from SAN Configuring Bo ot from SAN 2-4 IS0054604-00 A Configuring Boot from SAN Boot from SAN Inst allation on SLES 1 1 SP2 and RHEL 6.2 T o configure the adapter for BFS on SLES 1 1 SP2 or RHEL 6.2, follow these steps: 1. While the system is booting up, pre ss CTRL+Q to enter Fast!UTIL on the iSCSI BIOS banner , as shown in Figure 2-1 .
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-5 2. Once in, select the port to be configured, a s 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.
2–Boot from SAN Configuring Bo ot from SAN 2-6 IS0054604-00 A 4. Select Host Adapter Settings , as shown in Figure 2-4 . Figure 2-4. Selecting the Ho st Adapter Settings Option 5. Select the Initiator IP Settings field, as shown in Figure 2-5 . Figure 2-5.
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 th e Initiator IP Address 7. Press ESC repeatedly until the screen shown in Figure 2-7 appears. Then, select the iSCSI Boot Settings option.
2–Boot from SAN Configuring Bo ot from SAN 2-8 IS0054604-00 A 8. Select Primary Boot Device Settings, as shown in Figure 2-8 . Figure 2-8. Select ing Primary Boot Device Settings 9. Provide the target I P address, as shown in Figure 2-9 . Figure 2-9.
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-9 10. Select Alternate Boot Devi ce Settings, as shown in Figure 2-10 . Figure 2-10. Selecting Alternate Boot Device Settings 1 1. Provide the t arget IP address, as shown in Figure 2-1 1 . Figure 2-1 1.
2–Boot from SAN Configuring Bo ot 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 setti ngs. Figure 2-12. Fast!UTIL Options 13. In iSCSI Boot Settings, select Primary (LUN), as shown in Figure 2-13 .
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-1 1 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 step s 13 – 14 to edit the alternate b oot device setting, as in Figure 2-15 .
2–Boot from SAN Configuring Bo ot from SAN 2-12 IS0054604-00 A 16. Change the ad apter ’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, a nd configure the boot target s on the port.
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-13 Boot from SAN Inst allation on SLES 1 1 SP2 T o configure the adapter for BFS on SLES 1 1 SP2, follow these steps: 1. Boot from the SLES 1 1 SP2 DVD, as shown in Figu re 2-17 . Figure 2-17.
2–Boot from SAN Configuring Bo ot from SAN 2-14 IS0054604-00 A 3. The Welcome screen appears, as shown in Figure 2-19 . F ollow the instructions on this screen to begin the inst allation.
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-15 Figure 2-21. iSCSI Initiator Overview Figure 2-22. Selecting System Probing.
2–Boot from SAN Configuring Bo ot from SAN 2-16 IS0054604-00 A Figure 2-23. Selecting the Installation Mode Figure 2-24. Setting th e Clock and T ime Zone.
2–Boot from SAN Configuring Boot from SAN IS0054604-00 A 2-17 Figure 2-25. Selecting th e Server Base Scenario Figure 2-26. Preparing the Hard Disk.
2–Boot from SAN Configuring Bo ot from SAN 2-18 IS0054604-00 A Figure 2-27. Performi ng the Installation 5. When the inst allation is completed, reboot the syste m and boot from the iSCSI adapter .
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 Inst alling RHEL 6.2 T o install RHEL 6. 2, follow these steps: 1. Boot from the inst allation media, as shown in Figure 2-28 . Figure 2-28.
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-20 IS0054604-00 A 3. Select the network interface through wh ich the inst allation is to be done, as Figure 2-30 shows. Figure 2-30. Selecting Networ k Interface for Installation 4. Configure the IP address eith er st atically or using, as Figure 2-31 shows.
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-21 5. Once the network interface is configured, the inst allation starts, as shown in Figure 2-32 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-22 IS0054604-00 A 6. Select the language to use during the inst allation, as shown in Figure 2-33 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-23 7. Select the type of keyboard that is con nected to your system, as shown in Figure 2-34 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-24 IS0054604-00 A 8. Select one the two options shown in Fig ure 2-35 : Basic Storage Devices or Specialized S torage Devices . Y ou may select either option since the LUN has been added in the ad apter ’s BI OS.
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-25 9. Select the disk that was added in the adap ter ’s BIOS and verify that it ha s two paths to it, as sho wn in Figure 2-36 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-26 IS0054604-00 A 10. Enter the host name, a s shown in Figure 2-37 . Figure 2-37. Specifyi ng the Host Name.
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-27 1 1. Select the time zone, as shown in Figure 2-38 . Figure 2-38. Selecting the Time Zone.
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-28 IS0054604-00 A 12. Enter the root credentials t hat you want to set for the system, as shown in Figure 2-39 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-29 13. Select the type of p artition layout you want, as shown in Figure 2-40 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-30 IS0054604-00 A 14. Select the type of inst allation, as shown in Figure 2-41 . Figure 2-41.
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 IS0054604-00 A 2-31 15. The installer creates the p artitions on the disk and begins to cop y files to it, as show n in Figure 2-42 .
2–Boot from SAN Configuring Boot from SAN on RHEL 6.2 2-32 IS0054604-00 A 16. Once the files have been copied, the inst aller will prompt you to reboot the machine, as shown in Figure 2-42 .
2–Boot from SAN ql4xdisablesysfsboot Settin gs and Adapter Boot Mode IS0054604-00 A 2-33 ql4xdisablesysfsboot Settings and Adapter Boot Mode This section demonstrates the effect of the ql4xdisablesysf sboot parameter under differen t adapter boot modes.
2–Boot from SAN ql4xdisablesysfsboot Settings and Adap ter Boot Mode 2-34 IS0054604-00 A 2 Non-Boot from SAN a No target info is in the firm- ware 1 or 0 Disable Use iscsiadm for discov- ery and login to targets. The correct qla4xxx iface must be used.
IS0054604-00 A 3-1 3 Open-iSCSI User ’ s Guide This section provides a User’s Guide for Open-iSCSI. It inclu des the following topics: “Open-iSCSI Supported Features” on p age 3-2 “M.
3–Open-iSCSI User ’s Guide Open-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 1 1 Service Pack 2.
3–Open-iSCSI User’s Guide Open-iSCSI Supported Features IS0054604-00 A 3-3 Default Behavior on SLES 1 1 SP2 Open-iSCSI is enabled by default on SLES 1 1 SP2 and lo gin to boot targ ets is triggered by iscsiadm during insta llation.
3–Open-iSCSI User ’s Guide Managing QLogic iSCSI Adapters Using iscsiadm 3-4 IS0054604-00 A Managing QLogic iSCSI Adapters Using iscsiadm iSCSI Configuration Files and Persistent Dat abases The Op.
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adap ters Using iscsiadm IS0054604-00 A 3-5 2. Discover the iSCSI target. 3. List all discovered target s. 4. Log in to all discovered t argets. 5. List all sessions. # iscsiadm -m discovery -t st -p 192.
3–Open-iSCSI User ’s Guide Managing 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 a re bound should have its o wn iSCSI interface config file in /etc/ iscsi/ifaces .
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adap ters Using iscsiadm IS0054604-00 A 3-7 Example: IPv4 sample config file with st atic IP address List All ifaces # iscsiadm -m iface Example : # BEGIN RECORD 2.0-872 iface.iscsi_ifacename = qla4xxx-3 iface.
3–Open-iSCSI User ’s Guide Managing QLogic iSCSI Adapters Using iscsiadm 3-8 IS0054604-00 A Display iface Configuration Det ails # iscsiadm -m iface -I <iface_name> Example: Create an iface # iscsiadm -m iface -I <iface_name> -o new # iscsiadm -m iface -I qla4xxx.
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adap ters Using iscsiadm IS0054604-00 A 3-9 Example: Up date iface Network Parameters # iscsiadm -m iface -I <iface_name> -o update -n <rec.
3–Open-iSCSI User ’s Guide Managing QLogic iSCSI Adapters Using iscsiadm 3-10 IS0054604-00 A Example: IPv4 Settings (sta tic) Example: IPv4 Settings (DHCP) Example: IPv6 Settings (manual) Example: IPv6 Settings (neighbor disco very) # iscsiadm -m iface -I qla4xxx.
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adap ters Using iscsiadm IS0054604-00 A 3-1 1 Unidirectional and Bidi rectional 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 p arameters.
3–Open-iSCSI User ’s Guide Managing QLogic iSCSI Adapters Using iscsiadm 3-12 IS0054604-00 A T arget Discovery Discover T arget s using sendt arget # iscsiadm -m discovery -t st -p <target_ip:target_port> -I <iface_name> -o new, delete, update, nonpersistent In discovery mode, iscsiadm will use the iscsid.
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adap ters Using iscsiadm IS0054604-00 A 3-13 Adding a New discoverydb for send target # 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.
3–Open-iSCSI User ’s Guide Managing QLogic iSCSI Adapters Using iscsiadm 3-14 IS0054604-00 A Remove send target Node # iscsiadm -m discoverydb -t st -p <target IP> -I <iface> -o delete Example: # iscsiadm -m discoverydb -t st -p 192.168.
3–Open-iSCSI User’s Guide Managing QLogic iSCSI Adap ters Using iscsiadm IS0054604-00 A 3-15 List All T arget s # iscsiadm -m node Example: Deleting a T arget Node # iscsiadm -m node -T <target name> -p <target portal> -I <iface> -o delete Example: # iscsiadm -m node -T iqn.
3–Open-iSCSI User ’s Guide Managing QLogic iSCSI Adapters Using iscsiadm 3-16 IS0054604-00 A Login to All T arget s Not specifying the t arget name, portal, and ifa ce name results in login to all portals on all nodes/target s through each interface specified in the node co nfiguration.
3–Open-iSCSI User’s Guide Features Not Supported IS0054604-00 A 3-17 Features Not Supported The features below are not supporte d in Red Hat Enterprise Linux 6.2. These features will be supported in Red Hat Enterpr ise Linux 6.3. 1. iSNS 2. Ping Migrating to Open-iSCSI Driver On a system that was successfully upgraded from RHEL 6.
3–Open-iSCSI User ’s Guide Linux Open-iSCSI README 3-18 IS0054604-00 A Linux Open-iSCSI README Go to http://www .open-iscsi.org/docs/README for more det ailed information about Linux Open-iSCSI.
IS0054604-00 A 4-1 4 Known Issues This section lists curre ntly known issues and provides a brief explanation of each issue. QLogic Application Limit a tions The RHEL 6.
4–Known Issue s CHAP Limitations 4-2 IS0054604-00 A.
.
Corporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Ali so Viejo, CA 92656 949.389.6000 www .qlogic.com International Office s UK | Ireland | Germany | France | India | Japan | China | Hong Kong | Singapore | T aiwan © 2012 QLogic Corporation.
An important point after buying a device Q-Logic IS0054604-00 A (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Q-Logic IS0054604-00 A yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Q-Logic IS0054604-00 A - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Q-Logic IS0054604-00 A you will learn all the available features of the product, as well as information on its operation. The information that you get Q-Logic IS0054604-00 A will certainly help you make a decision on the purchase.
If you already are a holder of Q-Logic IS0054604-00 A, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Q-Logic IS0054604-00 A.
However, one of the most important roles played by the user manual is to help in solving problems with Q-Logic IS0054604-00 A. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Q-Logic IS0054604-00 A along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
