Simplify SANblade 2300 Series User’s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapters FC2354601-00 A Page i
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 document for any of these products are for illustrative purposes only.
Table of Contents Section 1 1.1 1.2 1.3 1.4 Introduction How to Use this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . General Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What is Fibre Channel? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Part I Hardware Section 2 QLA2340/2340L 2.1 2.1.1 2.1.2 2.2 2.2.1 2.3 2.3.1 2.3.2 2.3.2.1 2.3.2.2 2.3.2.3 2.3.2.
SANblade 2300 Series User’s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapters 2.7 2.7.1 2.7.2 Section 3 3.1 3.1.1 3.1.2 3.2 3.2.1 3.3 3.3.1 3.3.2 3.3.2.1 3.3.2.2 3.3.2.3 3.3.2.4 3.3.2.5 3.3.2.6 3.3.3 3.3.4 3.3.5 3.4 3.4.1 3.4.2 3.4.3 3.4.4 3.4.5 3.4.6 3.5 3.6 3.7 3.7.1 3.7.2 Section 4 4.1 4.2 4.3 4.4 Page iv Agency Certification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EMI and EMC Requirements . . . . . . . . . . . . . . . . . . . . . Product Safety Requirements . . . . . . .
SANblade 2300 Series User’s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapters Part II Software Section 5 Windows NT Driver Installation 5.1 5.2 5.3 5.3.1 5.3.2 5.3.3 5.4 5.4.1 5.4.2 5.4.2.1 5.4.2.2 5.5 5.5.1 5.5.2 5.5.3 5.5.3.1 5.5.3.2 5.5.4 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows NT Driver Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows NT Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANblade 2300 Series User’s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapters 6.5.3 6.5.4 Section 7 7.1 7.2 7.3 7.3.1 7.3.2 7.3.3 7.3.4 7.4 7.5 7.5.1 7.5.2 7.5.3 7.5.4 Section 8 8.1 8.2 8.3 Section 9 9.1 9.2 9.2.1 9.2.2 9.2.3 9.3 9.4 9.4.1 9.4.2 9.4.2.1 9.4.2.2 Page vi QL2x00IP NDIS Driver Configuration . . . . . . . . . . . . . . . Removing the QL2x00IP NDIS Driver . . . . . . . . . . . . . . . 6-7 6-9 Windows XP Driver Installation Introduction . . . . . . . . . . . . . . . . . . . . . . . .
9.4.2.3 9.4.2.4 9.4.2.5 9.5 9.5.1 9.5.2 SANblade 2300 Series User’s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapters Loading and Unloading the qla2x00 Driver Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a Ramdisk Image to Load the qla2300 Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Loading and Unloading the qla2300 Driver Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a Driver from the Sources .
SANblade 2300 Series User’s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapters 3-6 3-7 3-8 5-1 6-1 8-1 Page viii Fibre Channel Data Rates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . QLA2342/2342L HBA Operating Environment . . . . . . . . . . . . . . QLA2342/2342L HBA Specifications . . . . . . . . . . . . . . . . . . . . . Ql2x00ip.sys Configuration Parameters . . . . . . . . . . . . . . . . . . . Ql2x00ip.sys Configuration Parameters . . . . . . . . . . . . . . . . . . . QL2300.
Section 1 Introduction 1.1 How to Use this Guide The SANblade QLogic host bus adapters (HBAs) supported in this document are described in the following paragraphs; they are collectively referred to as the QLA23xx HBA unless otherwise noted. These HBAs are all low-profile, 64-bit PCI to Fibre Channel optical media.
1 – Introduction Features With its increased connectivity and performance, Fibre Channel is the I/O technology preferred and used by system designers. 1.4 Features 1-2 ■ Compliance with PCI Local Bus Specification revision 2.2 ■ Compliance with PCI-X Addendum (revision 1.
Part I Hardware This part of the SANblade 2300 User’s Guide describes the host bus adapters (HBAs) and how to install and configure them. See the section that corresponds to your HBA. Section 4 contains troubleshooting information.
I – Hardware I-2 FC2354601-00 A
Section 2 QLA2340/2340L 2.1 QLA2340/2340L HBA Components Figure 2-1 identifies the QLA2340/2340L HBA components referenced throughout this section. LED1 Each QLA2340/2340L HBA has a unique serial number; its location on the HBA is noted in figure 2-1. Take a minute to write down the serial number of the QLA2340/2340L HBA. J3 1 3 J1 ISP CHIP NOTE: The serial number is on the other side of the HBA. The QLA2340 has a full-height bracket (as shown in this figure).
2 – QLA2340/2340L Installation in the Computer 2.1.1 LEDs Figure 2-2 identifies and describes the activity of the QLA2340/2340L HBA LEDs. AMBER LED GREEN LED J1 CONNECTOR LEDs J1 CONNECTOR Green LED Amber LED On On Power On Off Online Off On Signal acquired Off Flashing Loss of synchronization Flashing Flashing Firmware error Activity Figure 2-2. QLA2340/2340L HBA LED Activity 2.1.
2 – QLA2340/2340L Installation in the Computer Perform the following steps to install the QLA2340/2340L HBA in your PC: 1. Check the motherboard and make any configuration changes necessary to accommodate the QLA2340/2340L HBA. The QLA2340/2340L HBA is self-configuring; however, some motherboards require manual configuration. For example, some systems have a PCI Device Configuration menu in the motherboard setup BIOS where you must enable HBAs, bus master slots, and IRQ levels.
2 – QLA2340/2340L Installation in the Computer 8. Connect the appropriate cable from the devices to the corresponding connector. 9. Carefully reinstall the computer cover. Insert and tighten the computer cover screws. 10. Power up all external FC devices, then power up the PC and observe the monitor. The BIOS is disabled by default. Consequently, the devices attached to the QLA2340/2340L HBA are not identified. For example: QLogic Corporation QLA23xx PCI Fibre Channel ROM BIOS Version x.
2 – QLA2340/2340L Fast!UTIL If you have a selectable boot BIOS and want to boot to an FC hard disk, set the motherboard BIOS parameters to None or Not Installed. The ROM BIOS on the QLA2340/2340L HBA automatically configures the FC peripherals. Some new system BIOSs support selectable boot, which supersedes the QLA2340/2340L HBA BIOS selectable boot setting. Select the QLA2340/2340L HBA FC hard disk in the system BIOS to boot from an FC hard disk attached to the QLA2340/2340L HBA. 2.
2 – QLA2340/2340L Fast!UTIL 2.3.2.1 Host Adapter Settings From the Configuration Settings menu in Fast!UTIL, select Host Adapter Settings. The default settings for the QLA2340/2340L HBA are listed in table 2-1 and described in the following paragraphs. Table 2-1.
2 – QLA2340/2340L Fast!UTIL Some new system BIOSs support selectable boot, which supersedes the Fast!UTIL selectable boot setting. To boot from an FC hard disk attached to the QLA2340/2340L HBA, select the QLA2340/2340L HBA FC hard disk on the system BIOS. NOTE: This option applies only to hard disks; it does not apply to tape drives and other nondisk devices. 2.3.2.
2 – QLA2340/2340L Fast!UTIL Table 2-2. Advanced Adapter Settings (Continued) Setting Options Disable Database Load Yes, No IOCB Allocation 1–512 buffers Extended Error Logging Enabled, Disabled 2-8 Default No 256 buffers Disabled ■ Execution Throttle. This setting specifies the maximum number of commands executing on any one port. When a port’s execution throttle is reached, no new commands are executed until the current command finishes executing.
2 – QLA2340/2340L Fast!UTIL NOTE: The driver being loaded must support this setting. If the driver does not support this setting, the result is the same as Disabled regardless of the setting. Leaving this option enabled guaranties a certified combination of software driver and RISC firmware. ■ Enable Database Updates. When enabled, this setting allows the software to save the loop configuration information in flash memory when the system powers down. The default is No. ■ Disable Database Load.
2 – QLA2340/2340L Fast!UTIL Table 2-3. Extended Firmware Settings (Continued) Setting Options Default Interrupt Delay Timer 0–255 0 Data Rate 0, 1, 2 2 ■ Extended Control Block. This setting enables all other extended firmware settings. The default is Enabled. ■ RIO Operation Mode. This setting specifies the reduced interrupt operation (RIO) modes, if supported by the software driver. RIO modes allow posting multiple command completions in a single interrupt (see table 2-4).
2 – QLA2340/2340L Fast!UTIL ■ Fibre Channel Confirm. This setting enables the host to send the FCP confirmation frame when requested by the target. The default is Enabled. This setting must be Enabled if the Fibre Channel Tape Support setting is Enabled. ■ Command Reference Number. This setting is reserved. The default is Disabled. ■ Read Transfer Ready. This setting is reserved. The default is Disabled. ■ Response Timer.
2 – QLA2340/2340L FCode 2.4 FCode This section provides instructions for installing FCode on a QLA2340/2340L HBA installed in a Solaris SPARC system. A QLA2340/2340L HBA with FCode loaded in its flash ROM provides boot capability to its attached devices. The following files are included. Be sure to review the Readme.txt file for both new and changed information. ■ ■ ■ ■ ifp2312.prom—FCode code binary file readme.
2 – QLA2340/2340L FCode 2.4.2 Setting the QLA2340/2340L HBA Connection Mode Perform the following steps to view the current QLA2340/2340L HBA connection mode and change it if necessary. NOTE: Due to possible equipment incompatibility, QLogic does not recommend selecting connection mode 3. 1. Select the QLA2340/2340L HBA attached to the Fibre Channel device from which you want to boot. For example, type the following at the ok prompt: ok " /pci@1f,0/pci@1/QLGC,qla@4" select-dev 2.
2 – QLA2340/2340L FCode 2.4.3 Setting the QLA2340/2340L HBA Loop ID When the QLA2340/2340L HBA is currently operating in loop mode (through connection mode 0 or connection mode 2), perform the following steps to view its loop ID and change it if necessary: 1. Select the QLA2340/2340L HBA attached to the Fibre Channel device from which you want to boot. For example, type the following at the ok prompt: ok " /pci@1f,0/pci@1/QLGC,qla@4" select-dev 2.
2 – QLA2340/2340L FCode Use the set-data-rate command to change the current QLA2340/2340L Fibre Channel data rate. For example: ok 1 set-data-rate Calculating NVRAM checksum, please wait... Current HBA data rate: Two Gigabit rate Table 2-6 lists the values to enter and their corresponding data rates. QLogic recommends the Auto-negotiated rate (2), which works for most devices. Table 2-6. Fibre Channel Data Rates Value Data Rate 0 One gigabit 1 Two gigabits 2 Auto-negotiated rate 2.4.
2 – QLA2340/2340L FCode The following displays: Calculating NVRAM checksum, please wait.... done Boot device login successful Boot WWN - 20000020 37009eeb WWPN - 22000020 37009eeb Id - 82 Lun - 0 ok 6. To boot the QLA2340/2340L HBA, type the complete boot path, including the loop ID and LUN. The loop ID and LUN must match those entered in step 5.
2 – QLA2340/2340L FCode If there were not at least 1.7 GB free on this disk, you would need to create a partition on the new bootable disk large enough to hold the largest temporary saveset files plus the largest used space on a partition. In this example, it would be a 3.2 GB (1.6 GB+1.6 GB) partition. 2. Use the format command to create, label, and format partitions on the new bootable disk. These partitions must be able to contain the contents of your temporary saveset files.
2 – QLA2340/2340L FCode 6. Use the ufsdump utility to copy the root partition to the new book disk. For example: ufsdump 0f - / | ufsrestore rf 7. Use the rm command to delete the restoresymtable file: rm restoresymtable 8. Install the boot block on the new boot disk. For example: installboot /usr/platform/’uname -i’ /lib/fs/ufs/bootblk /dev/rdsk/c3t130d0s0 NOTE: Platform-specific information (’uname -i’) varies depending on the hardware platform. 9.
2 – QLA2340/2340L Specifications 14. Create an alias entry for the new boot device (optional). For example: ok nvalias fibredisk /pci@1f,0/pci@1/QLGC,qla@4/sd@82,0 15. Set default boot device to be the new boot device (optional). For example: ok setenv boot-disk fibredisk 2.5 Specifications Tables 2-7 and 2-8 define the QLA2340/2340L specifications. Table 2-7.
2 – QLA2340/2340L Label Table 2-8.
2 – QLA2340/2340L Agency Certification ■ CE Mark 89/336/EEC EMC Directive ❑ EN55022:1998/CISPR22:1997 ❑ Radiated Emission ❑ Conducted Emission ❑ EN55024:1998 ❑ Immunity Standards ❑ EN61000-4-2 :1995 ❑ EN61000-4-3 :1995 ❑ EN61000-4-4 :1995 ❑ EN61000-4-5 :1995 ❑ EN61000-4-6 :1996 ❑ EN61000-4-8 : 1994 ❑ EN61000-4-11: 1994 ❑ EN61000-3-2:1995 ❑ EN61000-3-3:1994 ■ VCCI, Class B ■ CNS 13438 Class B ■ AS/NZS 3548 Class B Class B Class B Class B ESD RF Electro Magnetic Field Fast Transient/Burst Fast Su
2 – QLA2340/2340L Agency Certification 2-22 FC2354601-00 A
Section 3 QLA2342/2342L 3.1 QLA2342/2342L HBA Components Figure 3-1 identifies the QLA2342/2342L HBA components referenced throughout this section. Each QLA2342/2342L HBA has a unique serial number; its location on the HBA is noted in figure 3-1. Take a minute to write down the serial number of the QLA2342/2342L HBA. LED1 J3 1 3 J1 ISP CHIP LED2 J2 J4 1 3 NOTE: The serial number is on the other side of the HBA. The QLA2342 has a full-height bracket (as shown in this figure).
3 – QLA2342/2342L Installation in the Computer 3.1.1 LEDs Figure 3-2 identifies and describes the activity of the QLA2342/2342L HBA LEDs. AMBER LED GREEN LED J1 CONNECTOR LEDs J1 CONNECTOR Green LED Amber LED On On Power On Off Online Off On Signal acquired Off Flashing Loss of synchronization Flashing Flashing Firmware error J2 CONNECTOR J2 CONNECTOR LEDs GREEN LED AMBER LED Activity Figure 3-2. QLA2342/2342L HBA LED Activity 3.1.
3 – QLA2342/2342L Installation in the Computer Perform the following steps to install the QLA2342/2342L HBA in your PC: 1. Check the motherboard and make any configuration changes necessary to accommodate the QLA2342/2342L HBA. The QLA2342/2342L HBA is self-configuring; however, some motherboards require manual configuration. For example, some systems have a PCI Device Configuration menu in the motherboard setup BIOS where you must enable HBAs, bus master slots, and IRQ levels.
3 – QLA2342/2342L Installation in the Computer 8. Connect the appropriate cable from the devices to the corresponding connector. 9. Carefully reinstall the computer cover. Insert and tighten the computer cover screws. 10. Power up all external FC devices, then power up the PC and observe the monitor. The BIOS is disabled by default. Consequently, the devices attached to the QLA2342/2342L HBA are not identified. For example: QLogic Corporation QLA23xx PCI Fibre Channel ROM BIOS Version x.
3 – QLA2342/2342L Fast!UTIL If you have a selectable boot BIOS and want to boot to an FC hard disk, set the motherboard BIOS parameters to None or Not Installed. The ROM BIOS on the QLA2342/2342L HBA automatically configures the FC peripherals. Some new system BIOSs support selectable boot, which supersedes the QLA2342/2342L HBA BIOS selectable boot setting. Select the QLA2342/2342L HBA FC hard disk in the system BIOS to boot from an FC hard disk attached to the QLA2342/2342L HBA. 3.
3 – QLA2342/2342L Fast!UTIL 3.3.2.1 Host Adapter Settings From the Configuration Settings menu in Fast!UTIL, select Host Adapter Settings. The default settings for the QLA2342/2342L HBA are listed in table 3-1 and described in the following paragraphs. Table 3-1.
3 – QLA2342/2342L Fast!UTIL Some new system BIOSs support selectable boot, which supersedes the Fast!UTIL selectable boot setting. To boot from an FC hard disk attached to the QLA2342/2342L HBA, select the QLA2342/2342L HBA FC hard disk on the system BIOS. NOTE: This option applies only to hard disks; it does not apply to tape drives and other nondisk devices. 3.3.2.
3 – QLA2342/2342L Fast!UTIL Table 3-2. Advanced Adapter Settings (Continued) Setting Options Disable Database Load Yes, No IOCB Allocation 1–512 buffers Extended Error Logging Enabled, Disabled 3-8 Default No 256 buffers Disabled ■ Execution Throttle. This setting specifies the maximum number of commands executing on any one port. When a port’s execution throttle is reached, no new commands are executed until the current command finishes executing.
3 – QLA2342/2342L Fast!UTIL NOTE: The driver being loaded must support this setting. If the driver does not support this setting, the result is the same as Disabled regardless of the setting. Leaving this option enabled guaranties a certified combination of software driver and RISC firmware. ■ Enable Database Updates. When enabled, this setting allows the software to save the loop configuration information in flash memory when the system powers down. The default is No. ■ Disable Database Load.
3 – QLA2342/2342L Fast!UTIL Table 3-3. Extended Firmware Settings (Continued) Setting Options Default Interrupt Delay Timer 0–255 0 Data Rate 0, 1, 2 2 ■ Extended Control Block. This setting enables all other extended firmware settings. The default is Enabled. ■ RIO Operation Mode. This setting specifies the reduced interrupt operation (RIO) modes, if supported by the software driver. RIO modes allow posting multiple command completions in a single interrupt (see table 3-4).
3 – QLA2342/2342L Fast!UTIL ■ Fibre Channel Confirm. This setting enables the host to send the FCP confirmation frame when requested by the target. The default is Enabled. This setting must be Enabled if the Fibre Channel Tape Support setting is Enabled. ■ Command Reference Number. This setting is reserved. The default is Disabled. ■ Read Transfer Ready. This setting is reserved. The default is Disabled. ■ Response Timer.
3 – QLA2342/2342L FCode 3.4 FCode This section provides instructions for installing FCode on a QLA2342/2342L HBA installed in a Solaris SPARC system. A QLA2342/2342L HBA with FCode loaded in its flash ROM provides boot capability to its attached devices. The following files are included. Be sure to review the Readme.txt file for both new and changed information. ■ ■ ■ ■ ifp2312.prom—FCode code binary file readme.
3 – QLA2342/2342L FCode 3.4.2 Setting the QLA2342/2342L HBA Connection Mode Perform the following steps to view the current QLA2342/2342L HBA connection mode and change it if necessary. NOTE: Due to possible equipment incompatibility, QLogic does not recommend selecting connection mode 3. 1. Select the QLA2342/2342L HBA attached to the Fibre Channel device from which you want to boot. For example, type the following at the ok prompt: ok " /pci@1f,0/pci@1/QLGC,qla@4" select-dev 2.
3 – QLA2342/2342L FCode 3.4.3 Setting the QLA2342/2342L HBA Loop ID When the QLA2342/2342L HBA is currently operating in loop mode (through connection mode 0 or connection mode 2), perform the following steps to view its loop ID and change it if necessary: 1. Select the QLA2342/2342L HBA attached to the Fibre Channel device from which you want to boot. For example, type the following at the ok prompt: ok " /pci@1f,0/pci@1/QLGC,qla@4" select-dev 2.
3 – QLA2342/2342L FCode Use the set-data-rate command to change the current QLA2342/2342L Fibre Channel data rate. For example: ok 1 set-data-rate Calculating NVRAM checksum, please wait... Current HBA data rate: Two Gigabit rate Table 3-6 lists the values to enter and their corresponding data rates. QLogic recommends the Auto-negotiated rate (2), which works for most devices. Table 3-6. Fibre Channel Data Rates Value Data Rate 0 One gigabit 1 Two gigabits 2 Auto-negotiated rate 3.4.
3 – QLA2342/2342L FCode The following displays: Calculating NVRAM checksum, please wait.... done Boot device login successful Boot WWN - 20000020 37009eeb WWPN - 22000020 37009eeb Id - 82 Lun - 0 ok 6. To boot the QLA2342/2342L HBA, type the complete boot path, including the loop ID and LUN. The loop ID and LUN must match those entered in step 5.
3 – QLA2342/2342L FCode If there were not at least 1.7 GB free on this disk, you would need to create a partition on the new bootable disk large enough to hold the largest temporary saveset files plus the largest used space on a partition. In this example, it would be a 3.2 GB (1.6 GB+1.6 GB) partition. 2. Use the format command to create, label, and format partitions on the new bootable disk. These partitions must be able to contain the contents of your temporary saveset files.
3 – QLA2342/2342L FCode 6. Use the ufsdump utility to copy the root partition to the new book disk. For example: ufsdump 0f - / | ufsrestore rf 7. Use the rm command to delete the restoresymtable file: rm restoresymtable 8. Install the boot block on the new boot disk. For example: installboot /usr/platform/’uname -i’ /lib/fs/ufs/bootblk /dev/rdsk/c3t130d0s0 NOTE: Platform-specific information (’uname -i’) varies depending on the hardware platform. 9.
3 – QLA2342/2342L Specifications 14. Create an alias entry for the new boot device (optional). For example: ok nvalias fibredisk /pci@1f,0/pci@1/QLGC,qla@4/sd@82,0 15. Set default boot device to be the new boot device (optional). For example: ok setenv boot-disk fibredisk 3.5 Specifications Tables 3-7 and 3-8 define the QLA2342/2342L specifications. Table 3-7.
3 – QLA2342/2342L Label Table 3-8. QLA2342/2342L HBA Specifications (Continued) Type Specification NVRAM 256 bytes, field programmable Onboard DMA Five-channel DMA controller: two data, one command, one auto-DMA request, and one auto-DMA response Frame buffer FIFO Integrated 4-KB transmit and 6-KB receive frame buffer FIFO for each data channel Connectors Two LC-style connectors for multimode fibre optic cabling using a small form factor optical transceiver module Form factor 16.93 cm× 5.
3 – QLA2342/2342L Agency Certification ■ CE Mark 89/336/EEC EMC Directive ❑ EN55022:1998/CISPR22:1997 ❑ Radiated Emission ❑ Conducted Emission ❑ EN55024:1998 ❑ Immunity Standards ❑ EN61000-4-2 :1995 ❑ EN61000-4-3 :1995 ❑ EN61000-4-4 :1995 ❑ EN61000-4-5 :1995 ❑ EN61000-4-6 :1996 ❑ EN61000-4-8 : 1994 ❑ EN61000-4-11: 1994 ❑ EN61000-3-2:1995 ❑ EN61000-3-3:1994 ■ VCCI, Class B ■ CNS 13438 Class B ■ AS/NZS 3548 Class B Class B Class B Class B ESD RF Electro Magnetic Field Fast Transient/Burst Fast Su
3 – QLA2342/2342L Agency Certification 3-22 FC2354601-00 A
Section 4 Troubleshooting 4.1 Problems After Installation There are three basic types of installation problems that can cause your QLA23xx HBA to function incorrectly: hardware problems, system configuration problems, and Fibre Channel problems. The following section provides itemized checklists to help you determine why your QLA23xx HBA is not functioning. 4.
4 – Troubleshooting Fibre Channel Problem Checklist 4.4 Fibre Channel Problem Checklist ■ Were all of the FC devices powered up before you powered up the PC? ■ Check that all cables are properly connected. ■ Have you configured your RAID controller using the utilities provided by the manufacturer? ■ Some Fibre Channel switches support zoning. Make sure that your switch is configured correctly. ■ Make sure that Data Rate setting on the QLA23xx matches the target device.
Part II Software This part of the SANblade 2300 User’s Guide describes how to install the software drivers for the supported operating systems. See the section that corresponds to your computer’s operating system: Operating System Section Windows NT 4.0 5 Windows 2000 6 Windows XP 7 NetWare 4.2, 5.x, or 6.x 8 Red Hat Linux 6.2, 7.0, 7.1, 7.2 9 Solaris SPARC v2.
II – Software II-2 FC2354601-00 A
Section 5 Windows NT Driver Installation (QL2300.SYS) 5.1 Introduction This section provides instructions for installing the Windows NT driver under the following operating system conditions: ■ Initial installation of the Windows NT 4.0 operating system and the Windows NT driver ■ Installation of the Windows NT driver in an already installed Windows NT 4.0 operating system ■ Installing an updated Windows NT driver in an already installed Windows NT 4.
5 – Windows NT Driver Installation Windows NT Installation 5.3.1 Initial Installation of Windows NT and the Windows NT Driver Perform the following steps to install Windows NT 4.0 on a Fibre Channel hard disk attached to a QLA23xx HBA: 1. Insert the Windows NT setup disk or CD-ROM (if booting from a bootable CD-ROM drive) in an appropriate drive. 2. Restart your system. 3.
5 – Windows NT Driver Installation QLDIRECT 5.3.3 Updating the Windows NT Driver Perform the following steps if a Windows NT driver is already installed on a Fibre Channel hard disk attached to a QLA23xx HBA and you want to install an updated version of the driver. NOTE: This procedure does not modify the current registry parameters for the QLA2300 Windows NT driver. 1. Open a DOS command prompt window. 2. Change the current directory to the Windows NT driver directory.
5 – Windows NT Driver Installation QLDIRECT 5.4.1 QLDIRECT Driver Files Qldirect.sys requires the Ql2300.sys enhanced miniport driver version 7.00.00 or above. The latest version of the QLDIRECT driver and Ql2300.sys enhanced miniport driver for Windows NT are available on the QLogic Web site. 5.4.2 QLDIRECT Installation If QLDIRECT is not installed on your system, perform the installation procedures in section 5.4.2.1.
5 – Windows NT Driver Installation QL2x00IP NDIS Network Driver Installation 3. Insert the disk that contains the QLDIRECT driver in an appropriate drive. 4. Execute the Setup.exe installation program on the disk and follow the instructions on the screen. 5. Remove the disk that contains the QLDIRECT driver. 6. Restart your system to load the driver. 5.
5 – Windows NT Driver Installation QL2x00IP NDIS Network Driver Installation 7. In the Select OEM Option dialog box, select the QLogic QL2X00IP Network Driver, then click OK. 8. In the QLogic IP Configuration Utility dialog box, change the IP driver configuration parameters as appropriate. See the description of these parameters in section 5.5.3.1. Make sure the MTU size is set to the same value used on the other QLA22xx/QLA23xx HBAs in the network. Click OK. 9. Click Close. 10.
5 – Windows NT Driver Installation QL2x00IP NDIS Network Driver Installation 6. Remove the disk that contains the QLogic driver. 7. Restart your system to load the updated driver. 5.5.3 QL2x00IP NDIS Driver and IP Address Configuration You must configure the IP address and modify the driver parameters during the initial configuration as specified in section 5.5.1. You can also modify these later as appropriate using the following procedures. 5.5.3.
5 – Windows NT Driver Installation QL2x00IP NDIS Network Driver Installation ■ Header Split Size. This parameter accounts for packets with split headers and data. The parameter value specifies the number of bytes at the beginning of an incoming packet that must be isolated in the first receive buffer. A value of 0 indicates that the packet header and data are not split. QLogic recommends a default value of 0. ■ Adapter Node Name.
5 – Windows NT Driver Installation QL2x00IP NDIS Network Driver Installation 5. Click Close. 6. Click Yes to restart the computer. 5.5.4 Removing the QL2x00IP NDIS Driver If you need to remove the QLA2x00IP NDIS driver, perform the following steps: 1. Click the Start button, point to Settings, and then click Control Panel. 2. Double-click the Network icon, click the Adapters tab, select the QLA23xx HBA to be removed, and click Remove. 3. When the warning displays, click Yes to remove the driver. 4.
5 – Windows NT Driver Installation QL2x00IP NDIS Network Driver Installation 5-10 FC2354601-00 A
Section 6 Windows 2000 Driver Installation (QL2300.SYS) 6.
6 – Windows 2000 Driver Installation Windows 2000 Installation 6.3.1 Initial Installation of Windows 2000 and the Windows 2000 Driver Perform the following steps to install Windows 2000 on a Fibre Channel hard disk attached to the QLA23xx HBA: 1. Insert the Windows 2000 setup disk or CD-ROM (if booting from a bootable CD-ROM drive) in an appropriate drive. 2. Restart your system. 3. Follow the standard Windows 2000 installation instructions. 4.
6 – Windows 2000 Driver Installation Windows 2000 Installation 9. Click Finish. 10. Remove the disk that contains the QLogic driver from the drive, then click Yes to restart the system. 6.3.3 Updating the Windows 2000 Driver Perform the following steps if a Windows 2000 driver is already installed and you want to install an updated version of the driver. NOTE: The latest versions of the software drivers and documentation are available on the QLogic Web site, http://www.qlogic.com. 1.
6 – Windows 2000 Driver Installation QLDIRECT 6.
6 – Windows 2000 Driver Installation QL2x00IP NDIS Network Driver Installation 6.4.2.2 Updating to QLDIRECT from QLFILTER The QLDIRECT driver replaces the QLogic QLFILTER driver. You must first uninstall the QLFILTER driver before installing the QLDIRECT driver. Perform the following steps to update from the QLFILTER driver to the QLDIRECT driver: 1. Manually delete the Qlfilter.sys file from the following directory. For example: del C:\Winnt\System32\Drivers\Qlfilter.sys 2.
6 – Windows 2000 Driver Installation QL2x00IP NDIS Network Driver Installation 6.5.1 Initial Installation of the QL2x00IP NDIS Network Driver Perform the following steps to install the QL2x00IP NDIS network driver: 1. Click the Start button, point to Settings, then click Control Panel. 2. Double-click the Add/Remove Hardware icon. 3. The Add/Remove Hardware Wizard welcome screen displays. Click Next. 4. In the Choose a Hardware Task dialog box, click Add/Troubleshoot a device and click Next. 5.
6 – Windows 2000 Driver Installation QL2x00IP NDIS Network Driver Installation 3. Make a backup copy of the old driver. You can copy the file into the same directory with a .SAV extension indicating that it is the saved file. For example: copy Ql2x00ip.sys Ql2x00ip.sav 4. Insert the disk that contains the updated QLogic driver in an appropriate drive. 5. Copy the new driver over the old driver. For example: copy A:\W2k\Ip\Ql2x00ip.sys 6. Remove the disk that contains the QLogic driver. 7.
6 – Windows 2000 Driver Installation QL2x00IP NDIS Network Driver Installation ■ Buffer Size. This parameter specifies the size of each receive buffer. The buffer size multiplied by the number of buffers must be greater than or equal to the MTU size. Incoming packets cannot be broken into more than 23 buffers. Therefore, the buffer size multiplied by 23 must be at least as large as the MTU size. QLogic recommends a default value of 4096. ■ Header Split Size.
6 – Windows 2000 Driver Installation QL2x00IP NDIS Network Driver Installation 8. In the QLogic QLA2X00 PCI Adapter #n Properties dialog box, click the Advanced tab. 9. The Property list displays the configuration parameters. Click the parameter that you want to modify. The values display to the right. 10. Make configuration parameter modifications as necessary, then click OK. 11. In the Local Area Connection n Properties dialog box, click OK. 12. Restart the computer. 6.5.
6 – Windows 2000 Driver Installation QL2x00IP NDIS Network Driver Installation 6-10 FC2354601-00 A
Section 7 Windows XP Driver Installation (QL2300.SYS) 7.
7 – Windows XP Driver Installation Installing the Windows XP Driver 7.3.1 Installing Windows XP with the QLA23xx HBA as the Boot Device Follow these steps to initially install Windows XP and the QL2300.SYS driver on the boot disk attached to the QLA23xx HBA: 1. Start the Windows XP installation using the Setup disks or CD-ROM (CD). 2. If you are booting from the CD, press F6 if you see the message Press F6 if you want to install a third party SCSI or RAID Driver...
7 – Windows XP Driver Installation Installing the Windows XP Driver 4. Insert the QLogic disk created in section 7.2 into drive A. Press ENTER. 5. The following message displays: The software you are installing for this hardware: QLogic QLA23xx PCI Fibre Channel Adapter has not passed Windows Logo testing to verify its compatibility with Windows XP. Do you want to continue installing the software for this hardware? Click Yes to continue with the installation. 6.
7 – Windows XP Driver Installation Installing the Windows XP Driver 8. In the Upgrade Device Driver Wizard/Completing the Upgrade Device Driver Wizard dialog box, click Finish. 9. The following message displays: Your hardware settings have changed. You must restart your computer for these changes to take effect. Do you want to restart your computer now? Click Yes. NOTE: QLogic is in the process of obtaining a Digital Signature for the driver through the official WHQL process from Microsoft.
7 – Windows XP Driver Installation System Registry Parameters Follow these steps to complete the driver installation: 1. When the Digital Signature Not Found dialog box displays, click Yes. 2. When the Insert Disk message displays, insert the QLogic disk created in section 7.2 into drive A. Click OK. 3. In the Found New Hardware Wizard/Completing the Found New Hardware Wizard dialog box, click Finish. 4. The following message displays: Your hardware settings have changed.
7 – Windows XP Driver Installation System Registry Parameters To change this value, follow these steps: 1. Click Start, select Run, and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure to the QL2300.SYS driver: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double-click MaximumSGList:REG_DWORD:0x21. 4. Enter a value from 16 to 255 (10h to FFh). A value of 255 (FFh) enables the maximum 1-MB transfer size.
7 – Windows XP Driver Installation System Registry Parameters 4. If the string FCTape= does not display, add the following text to the end of the string: ;FCTape=1 5. If the string FCTape=0 displays, change the value from 0 to 1. 6. Click OK. 7. Exit the REGEDT32 program, then restart the system. 7.5.4 UseSameNN If you have multiple QLA23xx HBAs on the same system, the driver assigns the world wide node name obtained from the first HBA to the rest of the HBAs.
7 – Windows XP Driver Installation System Registry Parameters 7-8 FC2354601-00 A
Section 8 NetWare Driver Installation (QL2300.HAM) 8.1 Introduction This section provides instructions for installing the NetWare driver in an already installed Novell NetWare 4.2, 5.x, or 6.x system. NOTE: References to Novell NetWare 5.x and 6.x refer to versions that are currently supported by Novell. 8.2 NetWare Driver Files and Parameters The latest versions of the software drivers and documentation for NetWare 4.2, 5.x, and 6.x are available on the QLogic Web site. Be sure to review the README.
8 – NetWare Driver Installation Installing the NetWare Driver 8.3 Installing the NetWare Driver NOTE: The QL2300.HAM driver may not be compatible with NetWare versions earlier than 4.2. Perform the following steps to install the NetWare driver in a previously installed NetWare 4.2, 5.x, or 6.x system. NOTE: The following procedure modifies your NetWare STARTUP.NCF file to load the driver automatically when your system boots. 1.
Section 9 Red Hat Linux Driver Installation 9.1 Introduction This section provides instructions for installing the qla2300 Linux driver under the following operating system conditions: ■ Initial installation of the Red Hat Linux 6.2 operating system and the qla2x00 (v4.x) driver ■ Installing a new or upgrading an older version of the qla2x00 (v4.x) and qla2300 (v5.x and above) driver on an already installed Red Hat Linux 6.2, 7.0, 7.1, and 7.2 operating system.
9 – Red Hat Linux Driver Installation Creating the Driver Floppy Disk 5. Insert a blank floppy disk. 6. Run the self-extracting file you downloaded. At the Unzip To Folder prompt, specify A:\. Verify that the floppy disk contains the following files: ■ ■ ■ ■ ■ modules.cgz modules.dep modinfo pcitable rhdd-6.1 9.2.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) 9.3 Install a New Operating System and Driver (Red Hat Linux 6.2) NOTE: To install the qla2x00 driver, the following requirements must be met: ■ For Red Hat Linux 6.2, you must have created the qla2x00 driver floppy disk 1(see section 9.2.1). ■ The QLA23xx HBA must be installed in the system before installing the qla2x00 driver.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) loading the new driver automatically (see sections 9.4.2.1 and 9.4.2.2) or manually (see section 9.4.2). To load the qla2300 (v5.x) driver, see sections sections 9.4.2.2 and 9.4.2.3. NOTE: You must have created driver floppy disk 2 (from section 9.2.2) and a source code driver floppy disk (from section 9.2.3) before installing or updating the driver. 9.4.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) 9.4.2 Loading the Driver The qla2x00 or qla2300 driver must be loaded before the system can access the devices attached to the QLA23xx HBA. To build a custom kernel to automatically load the driver at boot time, see section 9.4.2.1. To build a ramdisk image to automatically load the qla2x00 driver at boot time, see section 9.4.2.2. To load the qla2x00 driver manually, see section 9.4.2.3.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) a. If you have Red Hat Linux 6.2 and want the qla2x00 driver added as a choice in make config, make menuconfig, or make xconfig, add the following line to the /usr/src/linux/drivers/scsi/Config.in file after line 116: dep_tristate ’QLA2x00 QLC driver support’ CONFIG_SCSI_QLOGIC_QLA2100 $CONFIG_SCSI b. Copy all the zipped qla2x00 source files to the /usr/src/linux/drivers/scsi directory. # cp /home/qla2x00/*.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) After line 609 add: **************** (hosts.c) ***************** #ifdef CONFIG_SCSI_QLOGIC_QLA2100 QLA2100_LINUX_TEMPLATE, #endif ****************** (end) ******************* 4. Build the kernel by first changing to the source directory. # cd /usr/src/linux (for Red Hat Linux 6.2 and 7.0) # cd /usr/src/linux-2.4 (for Red Hat Linux 7.1 and 7.2) 5. Type the following command to remove everything.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) 8. Copy the new kernel image to the boot directory. In the following example, newsmp is the label for the kernel image. # cd arch/i386/boot # cp bzImage /boot/newsmp 9. Modify the /etc/lilo.conf file to make the boot loader load a new image. For example: image=/boot/newsmp label=newsmp root=/dev/hda5 (This is the location of the boot partition on your system.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) 9.4.2.2 Building a Ramdisk Image to Load the Driver Automatically You can load the qla2x00 driver at boot time using a ramdisk image. For more information, refer to the Red Hat installation guide. Perform the following steps to load the qla2x00 driver using a ramdisk image: 1. For Red Hat Linux 6.2, add the following line to the file /etc/conf.modules. For Red Hat Linux 7.0, 7.1, and 7.
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) 5. Type the following command to load the new lilo file: # lilo 6. Restart the system. The qla2x00 driver loads automatically. 9.4.2.3 Loading and Unloading the qla2x00 Driver Manually Before loading the driver manually, first build the driver from the driver source files on the source code driver floppy disk (see section 9.5).
9 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) Linux 6.2 and 7.0), or to /lib/modules//drivers/scsi (Red Hat Linux 7.1 and 7.2). 3. Add the dependency for the qla2300 driver and build the ramdisk image. You can either run “depmod” or make sure the following line is in the /lib/modules//modules.dep file: /lib/modules//kernel/drivers/scsi/ qla2300.
9 – Red Hat Linux Driver Installation Building a Driver from the Sources To load the qla2300 driver, do one of the following: ■ For Red Hat Linux 6.2 and 7.0, copy qla2300.o to /lib/modules//scsi directory. For Red Hat Linux 7.1 and 7.2, copy qla2300.o to /lib/modules//drivers/scsi directory. ■ Update the dependency file. You can either run “depmod” or make sure that the following line is in the /lib/modules//modules.
9 – Red Hat Linux Driver Installation Building a Driver from the Sources 3. Build the qla2x00 driver from the sources. For Red Hat Linux 6.2 and 7.0, type: # make For Red Hat Linux 7.1 and 7.2, type: # make OSVER=linux-2.4 4. Build the qla2300 driver from the sources. For Red Hat Linux 7.1 and 7.2, type: # make ISP2300=1 9.5.2 Building a Multiprocessor Version of the Driver Perform the following steps to build an SMP version of the qla2x00 driver: 1.
9 – Red Hat Linux Driver Installation Building a Driver from the Sources a. From the Main Menu, select Processor type and features and press ENTER. b. From the Processor Type and Features Menu, select Symmetric multiprocessor and press the SPACEBAR. c. To exit the Main Menu, select Exit. The system prompts Do you wish to save your new kernel configuration? Select Yes. The system saves a new config file .config in the current directory. 5. Type the following: # make dep 6.
Section 10 Solaris SPARC Driver Installation (QLA2300) 10.1 Introduction This section provides instructions for installing the Solaris SPARC driver in an already installed Solaris SPARC operating system. The latest version of the Solaris SPARC driver package is available on the QLogic Web site. The files in the driver package cannot be read nor installed from a DOS environment. Be sure to review the README.TXT file for both new and changed information. To install the driver from a CD-ROM, see section 10.
10 – Solaris SPARC Driver Installation Installing the Solaris SPARC Driver from the QLogic Web Site 9. At the command prompt, type: pkgadd -d ./qla2300 10. Continue with step 7 in section 10.3. 10.3 Installing the Solaris SPARC Driver from the QLogic Web Site Perform the following steps to download the Solaris SPARC driver from the web to your hard disk, then install the driver on your system. NOTE: To install the QLA2300 driver, you must have superuser privileges. 1.
10 – Solaris SPARC Driver Installation Installing the Solaris SPARC Driver from the QLogic Web Site 9. You are prompted to select the directory where the driver will be installed. For example: Processing package instance from QLogic QLA2300 driver (sparc) Solaris 8-9, Rev=X.XX Copyright (c) 1996-2002, by QLogic Corporation. All rights reserved. Where do you want the driver object installed (default=/kernel/drv): 10. Press ENTER to accept the default. 11.
10 – Solaris SPARC Driver Installation FCode 10.4 FCode If you need FCode, see the appropriate section for instructions on how to install or update the FCode on the QLA23xx HBA.