FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x QLogic Corporation. All rights reserved. Table of Contents 1. Package Contents 2. OS Support 3. Supported Features 4. Deploying the Driver 4.1 Building the FC-FCoE Driver for RHEL 5.3 Linux 4.2 Building the FC-FCoE Driver for SLES 10 SP2 Linux 4.3 Building the FC-FCoE Driver for SLES 11 Linux 5. Driver Parameters 6. Additional Notes 6.1 Booting from SAN 6.2 Dynamically Modifying SCSI Blacklist Entries 7. Contacting Support 1. Package Contents The FC-FCoE Driver for Linux package contains the following files: File Name qla2xxx-src-x.xx.xx.xx.xx.xx-k.gz qla2xxx-src-vx.xx.xx.xx.xx.xx-k4.gz Description Compressed package that contains the driver for Red Hat RHEL 5.3 Compressed package that contains the driver for Novell SLES 10 SP2 and SLES 11 NOTE: xx represents the driver package version number. 2. OS Support The FC/FCoE Driver for Linux is compatible with the following OS platforms: Operating Systems OS Name OS Type Hardware Platform Red Hat RHEL AS 5.3 32-bit, 64-bit Intel x86, Intel 64, AMD64 Novell SLES 10 SP2 32-bit, 64-bit Intel x86, Intel 64, AMD64 Novell SLES 11 32-bit, 64-bit Intel x86, Intel 64, AMD64 FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 1 of 7
NOTE: For specific service packs (SP) and OS updates, refer to the descriptions where this software version is posted on the QLogic Web site: http://support.qlogic.com/support/drivers_software.aspx 3. Supported Features None 4. Deploying the Driver This section provides procedures for deploying the driver on various Linux versions, including the following: 4.1 Building the FC-FCoE Driver for RHEL 5.3 Linux 4.2 Building the FC-FCoE Driver for SLES 10 SP2 Linux 4.3 Building the FC-FCoE Driver for SLES 11 Linux 4.1 Building the FC-FCoE Driver for RHEL 5.3 Linux 1. In the directory that contains the source driver file, qla2xxx-src-x.xx.xx.xx.xx.xx-k.gz, issue the following commands: # tar -xzvf qla2xxx-src-x.xx.xx.xx.xx.xx-k.gz # cd qla2xxx-src-x.xx.xx.xx.xx.xx-k 2. Build and install the driver modules from the source code by executing the build.sh script as follows: The build.sh script does the following: * Builds the driver.ko files. * Copies the.ko files to the appropriate /lib/modules/2.6.../extra/qlgc-qla2xxx directory. * Adds the appropriate directive in the modprobe.conf (if applicable). 3. Manually load the driver for Linux Using insmod or modprobe. * To directly load the driver from the local build directory, issue the following commands in order: # insmod /lib/modules/2.6.../kernel/drivers/scsi/scsi_transport_fc.ko # insmod qla2xxx.ko * To load the driver using modprobe, issue the following command: # modprobe -v qla2xxx * To unload the driver using modprobe, issue the following command: # modprobe -r qla2xxx 4. Rebuild the RAM disk by issuing the following command: # cd /boot FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 2 of 7
5. Create a backup copy of the RAMDISK image by issuing the following commands: # cp initrd-[kernel version].img initrd-[kernel version].img.bak # mkinitrd -f initrd-[kernel version].img `uname -r` NOTE: Depending on the server hardware, the RAMDISK file name may be different. 6. To load the driver, reboot the host. 4.2 Building the FC-FCoE Driver for SLES 10 SP2 Linux 1. In the directory that contains the source driver file, qla2xxx-src-vx.xx.xx.xx.xx.xx-k.gz, issue the following commands: # tar -xzvf qla2xxx-src-vx.xx.xx.xx.xx.xx-k4.gz # cd qla2xxx-yy 2. Build and install the driver modules from the source code by executing the build.sh script as follows: The build.sh script does the following: * Builds the driver.ko files. * Copies the.ko files to the appropriate /lib/modules/2.6.../updates directory. * Adds the appropriate directive in the modprobe.conf (if applicable). 3. Manually load the driver for Linux Using insmod or modprobe. * To directly load the driver from the local build directories, issue the following commands in order: # insmod /lib/modules/2.6.../kernel/drivers/scsi/scsi_transport_fc.ko # insmod /lib/modules/2.6.../kernel/drivers/base/firmware_class.ko # insmod /lib/modules/2.6.../updates/qla2xxx.ko * To load the driver using modprobe, issue the following command: # modprobe -v qla2xxx * To unload the driver using modprobe, issue the following command: # modprobe -r qla2xxx 4. Rebuild the RAM disk by issuing the following command: # cd /boot 5. Create a backup copy of the RAMDISK image by issuing the following commands: # cp initrd-[kernel version].img initrd-[kernel version].img.bak # mkinitrd NOTE: Depending on the server hardware, the RAMDISK file name may be different. 6. To load the driver, reboot the host. FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 3 of 7
4.3 Building the FC-FCoE Driver for SLES 11 Linux 1. In the directory that contains the source driver file, qla2xxx-src-vx.xx.xx.xx.xx.xx-k4.gz, issue the following commands: # tar -xzvf qla2xxx-src-vx.xx.xx.xx.xx.xx-k4.gz # cd qla2xxx-yy 2. Build and install the driver modules from the source code by executing the build.sh script as follows: The build.sh script does the following: * Builds the driver.ko files. * Copies the.ko files to the appropriate /lib/modules/2.6.../updates directory. * Adds the appropriate directive in the modprobe.conf (if applicable). 3. Manually load the driver for Linux Using insmod or modprobe. * Edit the /etc/modprobe.d/unsupported_modules file to make the following change: allow_unsupported_modules 1 (replace 0 by 1) * To directly load the driver from the local build directories, issue the following commands in order: # insmod /lib/modules/2.6.../kernel/drivers/scsi/scsi_tgt.ko # insmod /lib/modules/2.6.../kernel/drivers/scsi/scsi_transport_fc.ko # insmod /lib/modules/2.6.../updates/qla2xxx.ko * To load the driver using modprobe, issue the following command: # modprobe -v qla2xxx * To unload the driver using modprobe, issue the following command: # modprobe -r qla2xxx 4. Build the driver in the RAM disk by issuing the following command: 5. Edit the /etc/modprobe.d/unsupported_modules file to make the following change: allow_unsupported_modules 1(replace 0 by 1) 6. Issue the following command: # cd /boot 7. Make a copy of the current RAMDISK by issuing the following commands: # cp initrd-[kernel version].img initrd-[kernel version].img.bak # mkinitrd NOTE: Depending on the server hardware, the RAMDISK file name may be different. FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 4 of 7
8. To load the driver, reboot the host. 5. Driver Parameters The driver gets its parameters when specified with the insmod command. For example: # insmod qla2xxx.ko ql2xextended_error_logging=1 If using the modprobe command, you must specify the parameters in the /etc/modprobe.conf file. For example: options qla2xxx ql2xextended_error_logging=1 Parameters for the FC-FCoE Driver for Linux include the following: Parameter ql2xlogintimeout Purpose Defines the login timeout value in seconds during the initial login. Default: 20 seconds qlport_down_retry Defines how long to wait for a port that returns a PORT-DOWN status before returning I/ O back to the OS. Default: 30 seconds ql2xplogiabsentdevice ql2xloginretrycount ql2xallocfwdump+ ql2xextended_error_logging ql2xfdmienable ql2xmaxqdepth ql2xqfullrampup ql2xqfulltracking ql2xfwloadbin Enables PLOGI to devices that are not present after a Fabric scan. This is needed for several broken switches. Default is 0 - no PLOGI. 1 - perform PLOGI. Specifies an alternate value for the NVRAM login retry count. Default is 8. Enables allocation of memory for a firmware dump during initialization. Memory allocation requirements vary by type. Default is 1 - allocate memory. Defines whether the driver prints verbose logging information. 0 to disable; 1 to enable. Default: 0. Enables FDMI registrations. Default is 0 - no FDMI. 1 - perform FDMI. Defines the maximum queue depth reported to SCSI mid-level per device. The Queue depth specifies the number of outstanding requests per LUN. Default is 32. Number of seconds to wait to begin to ramp-up of the queue depth for a device after a queue-full condition has been detected. Default is 120 seconds. Controls whether the driver tracks queue full status returns and dynamically adjusts a SCSI device s queue depth. Default is 1 to perform tracking. Set to 0 to disable tracking and adjustment of queue. Specifies location from which to load ISP firmware: 2 - load firmware via the request_firmware() interface. 1 - load firmware from Flash. 0 - use default semantics. To view a comprehensive list of parameters, enter the following command: # /sbin/modinfo qla2xxx 6. Additional Notes The following sections contain additional information: 6.1 Booting from SAN 6.2 Dynamically Modifying SCSI Blacklist Entries FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 5 of 7
6.1 Booting from SAN Booting from SAN means booting to the OS from a Fibre Channel target device. We recommend using the QLogic inbox driver to install the OS to a Fibre Channel target device that is attached to a QLogic adapter. If there is no QLogic inbox driver that supports the adapter, you should use a DD-kit to boot from SAN. RHEL 5.x - Boot from SAN Installation on Non-LUN 0 LUN NOTE: The following procedure is for the RHEL 5 distribution only. When installing to a LUN other than LUN 0 and LUN 0 is present, follow these steps to successfully boot from the LUN: 1. On the Boot Loader Configuration screen, select the Configure Advance Boot Loader Option, and then click Next. 2. On the Advanced Boot Loader Configuration screen, select Change Drive Order. 3. On the Edit Drive Order window, move the entry for the boot LUN. 4. To continue, click OK. 5. Continue with the OS installation as usual. 6.2 Dynamically Modifying SCSI Blacklist Entries On 2.6.x kernels, you can dynamically change the SCSI blacklist, either by writing to a /proc entry or using the scsi_mod module parameter, which allows persistence across reboot. This requires the SCSI Vendor/Model information for the SCSI device, available at /proc/scsi/scsi. Black list entries are in the following form: vendor:model:flags[v:m:f] Where flags can be the following integer values: 0x001 /* Only scan LUN 0 */ 0x002 /* Known to have LUNs, force scanning, deprecated: Use max_luns=n */ 0x004 /* Flag for broken handshaking */ 0x008 /* unlock by special command */ 0x010 /* Do not use LUNs in parallel */ 0x020 /* Buggy Tagged Command Queuing */ 0x040 /* Non-consecutive LUN numbering */ - -> value need to be passed to "flags" variable for sparse LUN 0x080 /* Avoid LUNS >= 5 */ 0x100 /* Treat as (removable) CD-ROM */ 0x200 /* LUNs past 7 on a SCSI-2 device */ 0x400 /* override additional length field */ 0x800 /*... for broken inquiry responses */ 0x1000 /* do not do automatic start on add */ 0x2000 /* do not send ms page 0x08 */ 0x4000 /* do not send ms page 0x3f */ 0x8000 /* use 10 byte ms before 6 byte ms */ 0x10000 /* 192 byte ms page 0x3f request */ 0x20000 /* try REPORT_LUNS even for SCSI-2 devs (if supports more than 8 LUNs) */ 0x40000 /* don't try REPORT_LUNS scan (SCSI-3 devs) */ 0x80000 /* don't use PREVENT-ALLOW commands */ 0x100000 /* device is actually for RAID config */ FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 6 of 7
0x200000 /* select without ATN */ 0x400000 /* retry HARDWARE_ERROR */ For example: # echo <VENDOR>:<MODEL>:040 > /proc/scsi/device_info To enable persistence across reboots: 1. Edit the following file (based on distribution): /etc/modprobe.conf for RHEL 5 2. Add the following line to the file: options scsi_mod dev_flags=<vendor>:<model>:<flags> 3. Rebuild the RAMDISK (refer to section 4.3, step 7). 7. Contacting Support Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Web: http://support.qlogic.com E-mail: support@qlogic.com Go to Top Copyright 2009. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners. FC-FCoE Adapter Inbox Driver Update for Linux Kernel 2.6.x Readme 7 of 7