This README file contains the latest information about updating the IBM DS4000/FAStT FC2-133 Host Bus Adapter BIOS to version 1.47. Refer to the IBM Support Website for the latest information and updated readme file. Last Update: 5/26/2005 Note: The 05/26/2005 update to the readme is to correct typos and add web package unpacking instruction in section 3.0. Products Supported: -------------------------------------------------------------------------- | FAStT/DS4000 Adapter| Qlogic Adapter |IBM Feature Code|IBM Option P/N| -------------------------------------------------------------------------- |FAStT FC2-133 | QLA2340-IBM-SP | FC2104 | 24P0960 | -------------------------------------------------------------------------- CONTENTS -------- 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Configuration Information 5.0 Unattended Mode 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer 1.0 Overview -------------- 1.1 Overview: This README file contains instructions for updating the IBM DS4000/FAStT FC2- 133 Host Adapter BIOS to Version 1.47. The new features are described below in the change history section. Please refer to this section for information on new features and modifications to the BIOS. Note: The Fast!UTIL utility program of the BIOS version 1.47 (or version 1.43) condenses the displaying of the adapter settings into two Fast!UTIL menu screens (Host Adapter settings and Advanced Adapter settings) instead of three menu screens like in the BIOS version 1.29. No new BIOS settings are introduced. However, the BIOS settings order and positions in a given menu may not match the order as shown in the IBM DS4000/FAStT FC2-133 Host Bus Adapter Installation and User Guide. In addition, some of BIOS settings that were documented in the Installation and User Guide are obsoleted. 1.2 Limitations: When connected to a DS4000/FAStT Storage subsystem and the host type is changed to a type other than WINDOWS, AIX, HP-UX, Solaris or PTX, the subsystem will not be Identified by the host adapter BIOS when "scan fibre devices" is run unless LUN 0 is present in that storage partition. 2.0 Change History -------------------- Changes from BIOS 1.29 to 1.47 ------------------------------ Rev 1.29 gh Jul. 10,2002 New version of Fastutil (1.19) to use 'Report Luns' SCSI command Added check in mailbox_command routine for interrupts enabled so we don't save mailbox registers. New version of risc code 3.01.12. Rev 1.30 gh Aug. 14,2002 Removed code that limited risc code to be loaded only from function 0. New version of risc code 3.01.13. New version of Fastutil (1.20) to set default data rate to 'auto'. Rev 1.31 gh Nov. 22,2002 New version of risc code 3.01.18. Rev 1.32 gh Nov. 23,2002 Fixed bug in handling CTRL-Q commands when commands vector to int40h ISR. Removed some unused code. Changed PCIR Class code to serial bus,fibre channel. New version of Fastutil (1.21) to check for max luns not eq to 0 before attempting to select luns and add support for memory mapped operation. Also removed option for enabling >4GB addressing. Remove Head of Queue flag from Execute IOCB command. Changed code to use a separate interrupt flag for each port instead of 1 global interrupt bit. This fixes potential problem when multiple ports are sharing the same IRQ. Rev 1.33 gh Jan. 26,2003 Fixed bug where INT13 read/write commands may not timeout under certain error conditions. Changed to byte order of WWN field of result buffer. New version of fasutil (1.22) to restore serial number from nvram even if nvram is corrupt and remove Compaq connection mode 1 filter. New version of risc code 3.01.20. Changed Compaq EV boot support to only function when selectable boot option is disabled. Rev 1.34 gh Mar. 31,2003 Added code to handle RSCN in 'error_proc' routine. New version of Fastutil (1.23) to disable interrupts during nvram21request routine and to blink LED when an adapter selected. Fixed bug configuring BIOS when system only supports memory map mode. Fixed bug in not finding boot lun when direct connect and gaps in luns. Added code to disable risc control of GPIO bits 6 & 7 before calling Fastutil. Removed Set Data Rate command after Init Firmware command. This was not needed and could cause problems. Added code to setup serial link options. Bypass some delays and retries after BIOS is loaded. This speeds up INT13h command processing when an error occurs. Rev 1.35 gh Jun. 11,2003 Changed format of PNP header product ID to use fewer bytes to idenitfy product. Change code to only allow 3 alternate boot devices. New version of fasutil (1.24) to allow only 3 alternate boot devices and added check for RLX BIOS and to get video buffer segment if RLX BIOS. Fixed hole in code where ISP needed to be reinited. Added code to check device supports Target mode before we scan for devices in auto_config routine. Added code to handle async event occuring during INT13h command processing. New version of risc code 3.02.12. gh Oct. 14,2003 (1.36) Changed code to only allocate 14kb instead of 32kb of of EBDA to use for decompressing RISC code. New version of risc code 3.02.17. Removed code to reset ISP when exiting BIOS Init routine and BIOS not loaded. (not needed) Changed code to retry login when 4007h status returned* during login_isp_database routine. Disable IOCB timeout for SCSI format (04h) command to keep format command from being timed out before format complete. gh Oct. 23,2003 (1.37) Changed code to not configure selectable boot drive when Start command fails. gh Nov. 14,2003 (1.38) Fixed bug where we were overwriting the first word of the INT15H interrupt handler. New version of risc code 3.02.18. New version of fasutil (1.25) to fix potential bug in displaying some screens correctly. gh Dec. 5,2003 (1.39) Changed code to use a common file for ISP2300/2312 bios (ql23rom.bin). This requires using Flasutil v1.35 or higher flash the BIOS correctly. New version of fasutil (1.26) to support common BIOS. New version of risc code 3.02.20. gh Jan. 29,2004 (1.40) New version of fasutil (1.27) to add Max Lun count to device block structure. Changed code to use extended interface risc code. Changed code to allow configuring a drive when selectable boot disabled and connected to switch. New version of risc code 3.02.22. gh Feb. 19,2004 (1.41) Fix bug where we could corrupt our drive block New version of risc code 3.02.24. gh Feb. 27,2004 (1.42) Changed code to GAN command instead of GETID3 command to locate first LUN0 boot device. Rev 1.43 gh Aug. 31,2004 (Apr. 5,2004) New version of risc code 3.02.28 gh July. 2,2004 (1.44) New version of fastutil (1.28) to fix bug that could cause garbage data to be displayed. New version of risc code 3.02.30. gh July 23,2004 (1.45) Clear out MB2 and MB3 for Set Firmware options. New version of risc code 3.03.01. gh Sept. 15,2004 (1.46) Fixed bug in setting up PNP structure correctly when target is logged out. Fixed potential problem in not unhooking Int15h. Rev 1.47 gh May 26, 2005 New version of fastutil (1.29) to fix bug with in selectlun routine. New version of risc code 3.03.08. There are three NVRAM options that are either set to different settings from the IBM FAStT Host Adapter or set to different values than the ones mentioned in the IBM DS4000/FAStT FC2-133 Host Bus Adapter Installation and User Guide. They are: 1. Connection options (change from IBM FAStT Host Adapter) The following connection options are supported: Value Connection --------- ----------------- 0 Start in loop mode, by transmitting Lip F7F7 1 Start in point-to-point mode, by transmitting NOS/OLS 2 Start in loop mode first, then switch to point- to-point mode if NOS is detected. Note: If the adapter is is connected to a Fabric like a switch port, it will attempt to log in as F-port first. The connection option is currently stored in the NVRAM and can be changed through the Fast!Util. The default value of the connection mode is 2. 2. Date Rate options The following connection options are supported: Value Data Rate --------- ----------------- 0 1Gbps 1 2Gbps 2 Auto negotiate the speed (1Gbps or 2Gbps) The connection option is currently stored in the NVRAM and can be changed through the Fast!Util. The default value of the data rate is 2. 3.0 Installation and Setup Instructions ----------------------------------------- Note: The web-download BIOS package for the IBM Fibre Channel Host Bus Adapter (FC HBA) must be first unpacked (unzipped) into a user-defined directory. Then, go to this directory, locate the *.exe file and run it to extract the bootable diskette image into a blank diskette. Once the image is put on the diskette, boot the server with the IBM FC HBA with this diskette and follow the instructions to update the BIOS flash and NVRAM. An alternative to using the bootable diskette or for servers that do not have diskette drive, the IBM FAStT Management Suite Java (FAStT MSJ) program can be used to update the BIOS flash and NVRAM. The flash *.bin and NVRAM *.dat file are included web-download BIOS package for this purpose. These files are used in conjunction with the IBM FAStT MSJ program to update the IBM FC HBA BIOS flash and NVRAM data without the need to reboot the servers to the diskette (use the password config when prompted) However, the server must be rebooted after the BIOS update via FAStT MSJ to enable it. The FAStT MSJ is available at the IBM TotalStorage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/servers/storage/support/disk/ Perform the following steps for updating the IBM DS4000/FAStT FC2- 133 Host Bus Adapter BIOS to version 1.47. This procedure assumes that you do not have the IBM DS4000/FAStT FC2-133 Host Bus Adapters in the same server with the other IBM Fibre Channel Host Adapters. 1. Insert either the bootable DS4000/FAStT FC2-133 Host Adapter CD that was shipped with your adapter into the CD-ROM drive or the bootable diskette that was created from the self-extractable file that was downloaded from IBM support website into the diskette drive. Restart the server. 2. The Intel-based server will boot to a RAM disk "c:\" prompt. The BIOS and NVRAM setting files were copied from either the CD or the diskette to this drive. 3. From a command line, type: "flasutil /l /f" This will update the BIOS and NVRAM for all of the 2340 adapters in the system. "flasutil /u" This will update adapter default BIOS setings with updated NVRAM for all of the 2340 adapters in the system. 4. Remove either the CD or the diskette and restart the server. For more information on the FLASUTIL program, either type "flasutil /?" at the command prompt or read the IBM DS4000/FAStT FC2-133 Host Bus Adapter Installation guide. If you do have the IBM DS4000/FAStT FC2-133 Host Adapters in the same server with the older IBM FAStT or DS4000/FAStT FC-2 Host Adapters, you must manually program each adapter at a time. Type 'flasutil" without any options to get to the list of adapters that you can select to update BIOS and NVRAM settings. The NVRAM settings in the Host Adapter are optimized, tested and supported for use in IBM supported SAN configurations. Please refer to the Readme.txt files that are included with the IBM DS4000/FAStT FC2-133 Operating System specific drivers for information on how to modify the NVRAM settings for a given Operating System environment. IMPORTANT: You can also configure most of the adapter NVRAM settings and download the BIOS to the adapter using the IBM FAStT Management Suite Java (FAStT MSJ) program. The NVRAM settings that can not be cofigured are "root boot" or "remote boot" settings. The FAStT MSJ is available at the IBM TotalStorage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/servers/storage/support/disk/ Note: This program might also be referred to as Qlogic SAN-Surfer in the future FAStT MSJ releases. Additional Adapter Configuration Notes ------------------------------------------- * For 2Gb FC Drives, change the Data Rate (Extended Firmware Settings) to 1. * If FC RAID target was used in a Cluster Environment, We recommend the Enable Target Reset setting of Enabled (Advanced Adapter Settings) and the Port Down Retry Count setting of 70. * BIOS scan (BIOS enabled) will not list devices attached to Fabric Fibre Channel Switch. If you want to boot to a single device attach to Fabric, please refer to note 6.1.2 (Selectable Boot Setting). * Use /I option if FlasUtil does not detect your controller. * Flasutil supports up to 16 QLA23XX controllers at a time. * IBM FC2-133 Jumper Setting Pins Optical Interface ---- ----------------- 1-2 Disabled 2-3 Enabled (default) * FC2-133 LED Setting Amber LED Green LED --------- --------- Power Off: Off Off Power On: On Steady On Steady Loss-of-Sync: 1/2 sec flash Off Signal Acquired: On Steady Off On-line: Off On Steady Firmware Error: 1/2 sec flash 1/2 sec flash Beacon: Off 1 sec flash Note: "1/2 sec" is only approximate. When I/O is running on the adapter, the LEDs are NOT designed to blink like a Network adapter. 4.0 Configuration Information: ------------------------------------------ You can configure the Fibre Channel Host Bus Adapter NVRAM settings using the adapter Fast!UTIL utility or the IBM FAStT Management Suite Java (FAStT MSJ) program. To access Fast!UTIL utility, press Ctrl+Q or Alt+Q during host BIOS initialization. it may take a few seconds for the Fast!UTIL menu to appear). If you have more than one FC2-133 adapter, Fast!UTIL will asks you to select the board you want to configure. After changing the settings, Fast!UTIL reboots your system to load the new parameters. The Fast!Util BIOS utility does not run on Sun SPARC systems or IA-64 servers. The FAStT MSJ program is available for Microsoft Windows and Linux operating systems at the IBM TotalStorage™ Disk Storage Systems Technical Support web site. Using this program, one can view the adapter NVRAM settings without the need to reboot the Microsoft Windows or Linux servers. However, the server will have to be rebooted to activater the change in NVRAM settings or BIOS. Note: This program might also be referred to as Qlogic SAN-Surfer in the future FAStT MSJ releases. This section provides detailed configuration information for advanced users who want to customize the configuration of the IBM FC2-133 Host Bus Adapter NVRAM. The information is presented assuming the user uses the Fast!UTIL utility. The configuration settings are divided into three categories: 1. Host Adapter Settings 2. Selectable Boot Settings 3. Advanced Adapter Settings CAUTION! If the configuration settings are incorrect, the IBM FC2-133 HBA may not function properly. 4.1 Host Adapter Settings ----------------------------- The Host Adapter Settings is accessed from the Configuration Settings menu. Host Adapter BIOS When this setting is disabled, the ROM BIOS on the FC2-133 HBA is disabled, freeing space in upper memory. This setting must be enabled if you are booting from an FC disk drive attached to the FC2-133 board. The default is Disabled. Frame Size This setting specifies the maximum frame length supported by the FC2-133 HBA. The default size is 2048, which provides maximum performance for F-Port (point-to-point) connections. Loop Reset Delay After resetting the loop, the firmware refrains from initiating any loop activity for the number of seconds specified in this setting. The default is 5 seconds. Adapter Hard Loop ID This setting forces the adapter to attempt to use the ID specified in the Hard Loop ID setting. The default is Enabled. Hard Loop ID If the Adapter Hard Loop ID setting is enabled, the adapter attempts to use the ID specified in this setting. The default ID is 125. It is recommended to set this ID to a unique value from 0-125 if there are more than one adapters connected to a FC-AL loop and the Adapter Hard Loop ID setting is Enabled. Spin Up Delay When this bit is set, the BIOS will wait up to five minutes to find the first drive. The default setting is disabled. Connection Options This setting defines the type of connection (loop or point to point) or connection preference. The default is 2 - which is loop preferred unless point-to-point. Fibre Channel Tape Support This setting enables FCP-2 recovery. The default is Enabled. It is recommended to change this setting to Disabled if the HBA is not connected to a Tape device. Data Rate This setting determines the data rate. When this setting is 0, the FC2-133 HBA runs at 1 gigabit/sec.When this setting is 1, the FC2-133 HBA runs at 2 gigabits/sec. When this setting is 2, Fast!UTIL determines what rate your system can accommodate and sets the rate accordingly. The default is 2 (auto-configure) 4.2 Selectable Boot Settings ------------------------------- The Selectable Boot Settings option is accessed from the Configuration Settings menu. If you enable this option, you can select the World Wide Name from which you want to boot. Once enabled, this option forces the system to boot on the selected FC drive. If you disable this option, the system looks for a boot device (as selected in the system BIOS). In disabled mode, the Boot ID and Boot LUN parameters have no effect. NOTE: 1. This option applies only to disk devices; it does not apply to tape drives and other nondisk devices. For new systems with Phoenix and AMI Multiboot BIOS the Selectable boot settings for the HBA will not work, unless the System BIOS "Hard Drive Boot" option is in the correct order. 2. Booting to FC Target attached to Fabric FC Switch such as IBM 2109-F16, you must enable Selectable Booting Settings and select the Node Name that you wish to boot to. Important: Please contact IBM support for the availablity of remote boot support. 4.3 Advanced Adapter Settings ------------------------------- From the Configuration Settings menu in Fast!UTIL, select Advanced Adapter Settings. The default settings for the FC2-133 HBA are as follows: 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. The valid options for this setting are 1-256. The default is 256. LUNs per Target This setting specifies the number of LUNs per target. Multiple LUN support is typically for redundant array of independent disks (RAID) boxes that use LUNs to map drives. The default is 0. For host operating systems other than Microsoft Windows, one may need to change this setting to a value other 0 to allow the host seeing more than one logical drive from the DS4000/FAStT storage server. Enable LIP Reset This setting determines the type of loop initialization process (LIP) reset that is used when the operating system initiates a bus reset routine. When this setting is yes, the driver initiates a global LIP reset to clear the target device reservations. When this setting is no, the driver initiates a global LIP reset with full login. The default is No. Enable LIP Full Login This setting instructs the ISP chip to re-login to all ports after any LIP. The default is Yes. Enable Target Reset This setting enables the drivers to issue a Target Reset command to all devices on the loop when a SCSI Bus Reset command is issued. The default is Yes. Login Retry Count This setting specifies the number of times the software tries to log in to a device. The default is 30 retries. Port Down Retry Count This setting specifies the number of seconds the software retries a command to a port returning port down status. The default is 30 seconds. In Microsoft Windows Cluster (MSCS) configurations, this setting should be changed to 70 secs. Link Down Timeout This setting specifies the number of seconds the software waits for a link down to come up. The default is 30 seconds. Extended Error Logging This setting provides additional error and debug information to the operating system. When enabled, events are logged into the Windows NT Event Viewer. The default is Disabled. 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. The default is 0. Interrupt Delay Timer This setting contains the value (in 100-microsecond increments) used by a timer to set the wait time between accessing (DMA) a set of handles and generating an interrupt. The default is 0. 4.4 Other functions in the Configuration Settings menu ------------------------------------------------------- Restore Default Settings ------------------------------ The Restore Defaults option from the Configuration Settings menu restores the FC2-133 HBA default settings. Raw NVRAM Data -------------------- This option displays the adapter’s NVRAM contents in hexadecimal format. This is a QLogic troubleshooting tool, you cannot modify the data. 4.5 Other FAStT!Util menu options ---------------------------------- Scan Fibre Channel Devices ------------------------------- This option scans the FC loop and lists all the connected devices by loop ID. Information about each device is listed, for example, vendor name, product name, and revision. This information is useful when configuring your FC2-133 HBA and attached devices. Fibre Disk Utility ----------------------- This option scans the FC loop and lists all the connected devices by loop ID. 1) Perform a low-level format 2) Verify the disk media. 3) Verify the disk data. 4) Select a disk device CAUTION! Performing a low-level format destroys all data on the disk. Loopback Data Test ---------------------- This option allows you to perform a Loopback test. Make sure that the FC loop is up or a Loopback plug is attached to the adapter before starting the test. - Do not do Loopback Data Test - Continue with Loopback Data Test Select Host Adapter ------------------------ If you have multiple FC2-133 HBAs in your system, use this setting to select and then configure or view the settings of a specific FC2-133 HBA. 5.0 Unattended Mode: ------------------------------- None. 6.0 WEB Sites and Support Phone Number ---------------------------------------- 6.1 IBM TotalStorage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/servers/storage/support/disk/ 6.2 IBM TotalStorage™ Marketing Web Site: http://www.ibm.com/servers/storage/disk 6.3 If you have any questions about this update, or problem applying the update go to the following HelpCenter World Telephone Numbers URL: http://www.ibm.com/planetwide ======================================================================= 7.0 Trademarks and Notices -------------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM FAStT TotalStorage™ the e-business logo xSeries HelpCenter Linux is a registered trademark of Linus Torvalds. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United states, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. ======================================================================= 8.0 Disclaimer -------------- 8.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 8.2 Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.